Smilo

Smilo

用小型 PyTorch 模型和 OpenCV，从照片、快照或实时摄像头画面中识别七种面部情绪。提供 Gradio 网页和桌面窗口两种用法。

由 ktejeshnaidu 在 Hugging Face 上制作。这些说明是 Mindket 根据它的 Space 页面和 README 写的，应用自己的文件和许可证在 Hugging Face 上。

简介

它是什么：Smilo 会把一张脸归入七种情绪之一，分别是生气、厌恶、恐惧、开心、平静、难过和惊讶。它可以对摄像头画面实时工作，也可以处理照片和快照。它用 OpenCV 找到人脸，再用一个小型 PyTorch 网络说出情绪。

适合谁：想要运行并阅读一个小而能用的情绪检测器的学生和开发者，以及好奇摄像头模型是怎么接起来的人，都适合用它。

Industry | Who uses it | How they use it | Example
机器学习 | 学生 | 从头到尾研究一个小型图像分类器 | 运行网页，测试一张照片
软件 | 开发者 | 给摄像头演示加上面部情绪标签 | 阅读 app.py 和 main.py
教育 | 老师 | 展示计算机是怎么读取面部表情的 | 对着摄像头微笑，看标签变化
研究 | 爱好者 | 在自己准备好的数据上重新训练网络 | 打开 README 提到的训练笔记本

需要生产级或临床级情绪工具的人可以跳过。

用在哪里：它可以在这些地方运行。

• 网页浏览器，打开 Hugging Face 上的 Space 页面
• Windows，需要 Python 3.10，桌面窗口还需要摄像头
• macOS，需要 Python 3.10
• Linux，需要 Python 3.10

Use case | Who | What they get back
检查一张照片 | 任何人 | 每张检测到的脸的情绪标签
接入摄像头实时画面 | 开发者和学生 | 画在视频上的实时标签
运行桌面窗口 | 开发者 | 一个在人脸上画框和标签的视频窗口

如何设置：在线使用这个 Space 只需要浏览器。在你自己的电脑上运行一份副本，需要下面这些。

• Python 3.10 和 pip
• huggingface_hub 包，它提供 hf 命令
• 一个摄像头，如果你想用实时视频
• 足够的磁盘空间，仓库里有 8 个文件

1. 安装 huggingface_hub 包。
2. 把这个 Space 的文件下载到本地文件夹。
3. 进入这个文件夹。
4. 安装这个 Space 使用的 Gradio 版本，再安装 requirements.txt 里的包。
5. 启动网页应用。

pip install -U huggingface_hub
hf download ktejeshnaidu/Smilo --repo-type space --local-dir Smilo
cd Smilo
pip install gradio==5.15.0
pip install -r requirements.txt
python app.py

如何使用：有两种运行方式。网页接受上传的照片、快照或实时摄像头画面。Gradio 会在终端里打印一个本地地址，供你打开。桌面脚本会用你的摄像头打开一个视频窗口，按 q 或关闭窗口即可退出。

python app.py
python main.py

Tool | What it does
app.py | 启动 Gradio 网页
main.py | 启动桌面视频窗口
face_classifier.pth | 存放训练好的情绪模型
classes.pkl | 存放情绪类别名称

示例：你运行 python app.py，打开页面并开启摄像头。页面会在你的脸上画一个框，并随着你表情的变化显示 happy 或 surprise 之类的标签。

新手与专家：先用在线 Space 和一张光线好的单人清晰照片开始。正对镜头会让结果更好。

找人脸用的是 OpenCV 的 Haar 级联。情绪识别是一个自定义网络，有三层卷积，用 PyTorch 编写，在 128 乘 128 的彩色图像上训练。视频路径会跳帧并并发处理，README 说这样能让实时视频保持在每秒 30 帧以上。README 还指向一个用于重新训练的训练笔记本。

一帧画面来自照片或摄像头
OpenCV 找出人脸
PyTorch 网络给七种情绪打分
标签画在图像上

注意事项：光线差或脸偏向一侧，会降低标签的准确度。

• License: mit，README 指向一个 LICENSE 文件
• Cost to run: 未提及
• Data it reaches: 你上传的照片和你的摄像头视频
• Not for: 判断一个人的真实感受，因为它只是把面部表情归入七个类别
• Hardware: 这个 Space 设为在 Hugging Face 的 cpu-basic 上运行，你自己的电脑需要什么，来源没有说明

Hugging Face 上的数据（2026年11月13日）

• 点赞：3
• 构建方式：gradio
• 许可证：mit

链接

• Space：https://huggingface.co/spaces/ktejeshnaidu/Smilo
• 文件：https://huggingface.co/spaces/ktejeshnaidu/Smilo/tree/main

试用

在浏览器里打开这个 Space，或在它的页面上把它复制到你自己的 Hugging Face 账号。这个工具包里没有会自己运行的东西。