uniface

环境要求

• 已安装 Python 与 pip（README 未标明最低 Python 版本）
• 纯 CPU 或 Apple Silicon 机器请选择 uniface[cpu] 套件
• NVIDIA CUDA 环境请选择 uniface[gpu] 套件
• README 首个示例脚本同时导入了 cv2（OpenCV），需要环境中可用

安装与启动步骤

1. 1准备 Python 环境

   建议先建独立虚拟环境再安装，避免与已有深度学习依赖冲突；创建后按系统提示激活。

   python -m venv .venv

   复制

2. 2安装 CPU 版

   适用于普通 CPU 机器与 Apple Silicon；注意 extras 的方括号必须加引号，防止被 shell 展开。

   pip install "uniface[cpu]"

   复制

3. 3安装 GPU 版

   仅在有 NVIDIA CUDA 环境时选择，与 CPU 版二选一，安装 uniface[gpu]。

   pip install "uniface[gpu]"

   复制

4. 4安装预发布版

   需要尝鲜最新 pre-release 时，在安装命令中加 --pre 参数。

   pip install --pre "uniface[cpu]"

   复制

5. 5验证导入

   用 README 示例中出现的 FaceAnalyzer、FairFace 做导入检查，不报错即安装成功。

   python -c "from uniface import FaceAnalyzer, FairFace; print('uniface import ok')"

   复制

如何确认成功

执行导入检查命令，能正常打印 uniface import ok 且无 ModuleNotFoundError，即说明库安装成功。

常见问题

注意事项

• 本次 README 节选只包含安装命令和首个脚本的开头，完整使用示例请查阅官网文档与 Notebooks 页面。
• pip 安装命令中的 extras 方括号务必用引号包裹，否则部分终端会做通配符展开导致安装失败。
• 属性模型属于可选启用（opt-in），首个脚本中 FaceAnalyzer 一次性完成检测、对齐与识别。