Faceplugin-ltd/Open-Source-Face-Recognition-SDK

开源人脸识别 SDK – 快速概览

它是什么：一个免费、本地部署的 Python SDK，让您可以检测人脸、提取特征点、生成特征嵌入并比较两张人脸。它在 Windows 或 Linux 上运行，并支持 CPU（GPU 为选配）。该库基于深度学习模型构建，但仅提供推理代码，因此数据永远不会离开主机。

主要功能

• 检测图像中的单个人脸或多人脸并返回边界框。
• 提供 5 点（或更多）面部特征点。
• 为每张人脸生成数值嵌入（“特征向量”）。
• 计算两个嵌入之间的相似度分数（0-100）；建议使用默认的 75% 阈值作为“同一人”的判断标准。

典型工作流程 (Python)

from face_recognition_sdk import FaceRecognition

sdk = FaceRecognition()                     # 初始化
info = sdk.GetImageInfo('photo.jpg', 10)    # 人脸列表 → 边界框、特征点、嵌入
sim = sdk.get_similarity(info[0]['embedding'], other_embedding)
print(f'Similarity: {sim}%')

该 SDK 支持常见的图像格式（JPG, PNG, BMP, TIFF）并且可以处理每张图像中的多个人脸。

安装

1. 安装 Anaconda（推荐）。
2. 创建一个 Python ≥ 3.9 的 conda 环境。
3. pip install -r requirements.txt。
4. 运行 python run.py 以验证安装。

为什么使用它

• 隐私优先：所有计算都保留在设备上 – 非常适合对安全性敏感或受监管的环境。
• 免费：无授权费用；您可以将其嵌入到商业或内部工具中。
• 跨平台：适用于 Windows 和 Linux，并可选配 GPU 加速。

典型应用场景

• 门禁或生物识别登录系统。
• 考勤追踪。
• 零售分析、访客管理或任何需要设备端人脸匹配的应用程序。

限制

• 本仓库仅提供推理 API；不包含训练新模型的功能。
• 准确性和性能取决于捆绑的深度学习模型（README 中未披露详细信息）。
• 没有内置活体检测 – 您需要单独的解决方案来进行防欺骗。

下一步

• 同一家公司提供商业 SDK，具有额外功能，例如活体检测、身份证件 OCR 以及多平台移动库（Android, iOS, Flutter, React-Native 等）。
• 对于更高级的需求，请探索这些付费产品或整合单独的防欺骗模块。

---

以上所有信息均直接取自该项目的 README。