Repolode
提交项目
yakhyo

yakhyo/uniface

统一的 Python 人脸分析库，用一套 API 覆盖检测、识别、关键点、gaze、属性和活体检测等任务。

在 GitHub 查看官网
Star
2,199
Fork
310
未关闭 Issue
5
最近提交
昨天

这是什么？

UniFace 是一个 Python 人脸分析库，把人脸检测、识别、目标跟踪、关键点、Face Mesh、人脸解析、人像抠图、头部姿态、视线估计、年龄性别、表情、人脸状态、质量评估、活体检测和匿名化等功能放在同一套接口下。FaceAnalyzer 一次调用即可完成检测、对齐和识别，FairFace、AgeGender 等属性预测器可按需加入，为每张人脸补充额外字段。

模型通过 ONNX Runtime 运行，支持 CPU、Apple Silicon 和 NVIDIA CUDA，安装时可选择 cpu 或 gpu 版本。权重在首次使用时自动下载，并通过 SHA-256 校验。模型包括 RetinaFace、SCRFD、ArcFace、AdaFace、BiSeNet、MODNet、MiniFASNet 等。

部分预训练权重的许可证与库本身的 MIT 许可不同，商用前需要先确认各模型的许可证。

核心功能

  • 01检测、识别和跟踪集中在一个 FaceAnalyzer 流程中完成
  • 02支持 68 至 478 点关键点，包括 3D Face Mesh
  • 03提供年龄、性别、种族、表情和人脸状态等属性预测
  • 04支持头部姿态与视线估计
  • 05包含活体检测、人脸质量评分和 5 种匿名化模糊方法
  • 06通过 ONNX Runtime 在 CPU、Apple Silicon 和 CUDA 上运行

适用场景

  • 在 Python 计算机视觉项目中加入人脸检测与识别
  • 构建跨帧跟踪人脸的视频处理流程
  • 对照片或视频中的人脸做匿名化处理
  • 在人脸比对的同时进行活体检测

快速上手

  1. 1

    安装 CPU 版本（也适用于 Apple Silicon）

    pip install "uniface[cpu]"
  2. 2

    或者安装 NVIDIA CUDA 版本

    pip install "uniface[gpu]"
  3. 3

    运行第一个示例：从照片中检测人脸并输出属性

使用前须知

  • 部分预训练模型权重并非 MIT 许可，商业使用前需先核对许可条款。

收录于专题

计算机视觉工具与库

标签

#computer-vision#face-recognition#face-detection#onnxruntime#deep-learning#facial-landmarks#face-alignment#face-analysis#face-anonymization#face-anti-spoofing

常见问题

uniface 是什么？
统一的 Python 人脸分析库，用一套 API 覆盖检测、识别、关键点、gaze、属性和活体检测等任务。 UniFace 是一个 Python 人脸分析库，把人脸检测、识别、目标跟踪、关键点、Face Mesh、人脸解析、人像抠图、头部姿态、视线估计、年龄性别、表情、人脸状态、质量评估、活体检测和匿名化等功能放在同一套接口下。FaceAnalyzer 一次调用即可完成检测、对齐和识别，FairFace、AgeGender 等属性预测器可按需加入，为每张人脸补充额外字段。
uniface 可以免费使用吗？用的什么许可证？
uniface 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
uniface 还在维护吗？
活跃维护中。uniface 最近一次提交是在 2026年11月6日。
uniface 适合用来做什么？
在 Python 计算机视觉项目中加入人脸检测与识别 构建跨帧跟踪人脸的视频处理流程 对照片或视频中的人脸做匿名化处理 在人脸比对的同时进行活体检测
uniface 怎么安装和运行？
安装 CPU 版本（也适用于 Apple Silicon）: pip install "uniface[cpu]" 或者安装 NVIDIA CUDA 版本: pip install "uniface[gpu]" 运行第一个示例：从照片中检测人脸并输出属性
在哪里获取 uniface？
源代码和安装说明在 GitHub 上：https://github.com/yakhyo/uniface

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目