# AI1101-project

**Repository Path**: wang-yuchun28/AI1101-project

## Basic Information

- **Project Name**: AI1101-project
- **Description**: 本项目实现对猫咪面部表情的实时情绪识别。通过香橙派（Orange Pi）开发板搭载轻量级卷积神经网络（MobileNetV3），对摄像头采集的猫咪图像进行预处理、特征提取与分类，可识别 “愤怒”“悲伤”“快乐” 及 “其他” 四种情绪状态。系统集成语音播报功能（离线语音合成库 pyttsx3），当检测到情绪变化时自动播报结果，并通过 CSV 文件记录情绪类型、置信度及时间戳，支持后续行为分析。
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-05
- **Last Updated**: 2025-10-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI1101-project

#### 介绍
本项目实现对猫咪面部表情的实时情绪识别。通过香橙派（Orange Pi）开发板搭载轻量级卷积神经网络（MobileNetV3），对摄像头采集的猫咪图像进行预处理、特征提取与分类，可识别 “愤怒”“悲伤”“快乐” 及 “其他” 四种情绪状态。系统集成语音播报功能（离线语音合成库 pyttsx3），当检测到情绪变化时自动播报结果，并通过 CSV 文件记录情绪类型、置信度及时间戳，支持后续行为分析。

#### 软件架构
编程语言：Python 3.8
深度学习框架：PyTorch 2.0
计算机视觉：OpenCV 4.9
语音合成：pyttsx3（离线引擎，默认英文语音）
版本管理：Git


#### 安装教程
#环境准备
确保香橙派已安装 Linux 系统（如 Armbian、Ubuntu 等），并连接好摄像头、音频输出设备（扬声器 / 耳机 ）。
#步骤 1：克隆项目代码
打开终端，执行以下命令克隆仓库到香橙派：
bash
git clone https://gitee.com/your-username/cat-emotion-detection.git  
cd cat-emotion-detection  

#步骤 2：安装系统依赖
通过系统包管理器安装基础依赖（以 Debian/Ubuntu 为例 ）：
bash
sudo 更新软件源  
sudo apt update  

安装语音合成引擎（英文默认支持）、图像依赖  
sudo apt install espeak python3-pip  

#步骤 3：安装 Python 依赖
使用 pip 安装项目所需 Python 库，执行：
bash
pip install -r requirements.txt  

#依赖说明（requirements.txt 内容 ）：
plaintext
torch>=2.0.0  
torchvision>=0.15.0  
opencv-python>=4.7.0  
pyttsx3>=2.90  
Pillow>=9.0.0  
numpy>=1.23.0  

#步骤 4：准备模型文件
将训练好的模型权重文件（如 cat_emotion_best_model.pth ）

#### 使用说明

启动程序
在项目根目录终端，执行以下命令启动情绪检测：
bash
python run.py