Exadel CompreFace：免费开源的人脸识别系统
CompreFace 是由 Exadel 推出的免费开源人脸识别服务，基于 FaceNet 与 InsightFace，通过 Docker/docker-compose 部署，提供人脸识别、人脸验证、人脸检测、关键点检测、口罩检测、头部姿态检测以及年龄与性别识别的 REST API，并带有角色与权限管理面板，无需机器学习经验即可集成到任意系统。
社区作者 · zZz
它解决什么问题
项目概述
Exadel CompreFace 是一个免费、开源的人脸识别 GitHub 项目，本质上是一个基于 Docker 的应用，既可以作为独立服务器运行，也可以部署到云端。官方强调：即使没有机器学习背景，也可以搭建并使用 CompreFace。
系统提供 REST API，覆盖以下能力：人脸识别（face recognition）、人脸验证（face verification）、人脸检测（face detection）、关键点检测（landmark detection）、口罩检测（mask detection）、头部姿态检测（head pose detection）、年龄识别与性别识别。解决方案还包含角色管理系统，便于控制谁可以访问你的人脸识别服务。
CompreFace 以 docker-compose 配置形式交付，支持可在 CPU 与 GPU 上运行的不同模型；其方案基于 FaceNet 和 InsightFace 等前沿方法与库。
界面与截图
官方页面提供了多张界面截图（配图 1 至配图 11），按输入顺序包括：配图 1（angular-logo）、配图 2（compreface-recognition-page）、配图 3（compreface-dashboard-page）、配图 4（compreface-verification-page）、配图 5（compreface-detection-page）、配图 6（compreface-services-page）、配图 7（compreface-wizzard-page）、配图 8（CompreFace Face Detection Demo）、配图 9（CompreFace Appery.
io Demo）、配图 10（CompreFace .NET SDK Demo）、配图 11（CompreFace JavaScript SDK Demo）。页面另设有 More Screenshots 与 More Videos 入口。
特性（Features）
据官方说明，系统即使只“看过”某人一张照片也能较准确地识别该人。CompreFace 相对于同类免费人脸识别方案的优势包括：
- 同时支持 CPU 与 GPU，且易于横向扩展；
- 开源且自托管，为数据安全提供额外保障；
- 可部署在云端或本地（on premises）；
- 无需机器学习专业知识即可搭建和使用；
- 使用 FaceNet 与 InsightFace 库，采用前沿的人脸识别方法；
- 只需一条 docker 命令即可快速启动。
功能清单（Functionalities）
支持多种人脸识别服务：
并可通过 CompreFace UI 面板进行便捷的用户角色与访问管理（配图 3 仪表盘、配图 6 服务页、配图 7 向导页）。
- 人脸检测（face detection）
- 人脸识别（face recognition）
- 人脸验证（face verification）
- 关键点检测插件（landmark detection plugin）
- 年龄识别插件（age recognition plugin）
- 性别识别插件（gender recognition plugin）
- 口罩检测插件（face mask detection plugin）
- 头部姿态插件（head pose plugin）
目录结构概览
官方 README 的目录涵盖：Overview、Screenshots、Video tutorials、News and updates、Features、Functionalities、Getting Started with CompreFace、CompreFace SDKs、Documentation、How to Use CompreFace、Face Services and Plugins、Rest API Description、Postman documentation and collection、Face Recognition Similarity Threshold、Configuration、Architecture and Scalability、Custom Builds、Face data migration、User Roles System、Face Mask Detection Plugin、Kubernetes configuration、Gathering Anonymous Statistics、Installation Options、Contributing、License info。
SDK 与生态
CompreFace 提供官方 SDK：
页面上还有 Appery.io 相关演示（配图 9）。官方鼓励社区为喜欢的编程语言创建 SDK，并把 CompreFace 集成到 Home Assistant、DreamFactory 等平台，官方会将其加入文档。
- JavaScript：https://github.com/exadel-inc/compreface-javascript-sdk （配图 11 为 JavaScript SDK Demo）
- Python：https://github.com/exadel-inc/compreface-python-sdk
- .NET：https://github.com/exadel-inc/compreface-net-sdk （配图 10 为 .NET SDK Demo）
文档与社区
- 官网与文档：README 中提供 Official website 与 Documentation 链接
- 贡献指南：Contributing 链接，另有 Submit an Issue、Blog、Community chat
- Postman 文档与集合、Rest API 说明、相似度阈值说明、配置、架构与可扩展性、自定义构建、人脸数据迁移、用户角色系统、口罩检测插件、Kubernetes 配置、匿名统计收集、安装选项等均在 README 目录中列出
- 可订阅 CompreFace News and Updates 获取新功能与产品改进信息
适用对象
需要在自有基础设施内完成人脸识别/检测能力集成，同时又希望规避第三方云服务、对数据安全有要求的团队与个人开发者；没有机器学习经验但会用 Docker 的使用者；以及希望为 CompreFace 贡献代码、插件或 SDK 的贡献者。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
准备环境（Requirements）
步骤 1 · 安装 Docker 和 Docker Compose（或
Docker Desktop）。
- 硬件要求：CompreFace 可运行在大多数具备 x86 处理器且支持 AVX 的现代计算机上。
- 检查 AVX 支持：在 Linux 上运行命令
lscpu | grep avx。
快速开始（Linux、macOS）
按官方顺序执行：
- 安装 Docker 和 Docker Compose。
- 从最新 release 下载归档文件：https://github.com/exadel-inc/CompreFace/releases
- 解压该归档文件。
- 在该文件夹中打开终端，运行命令：
docker-compose up -d- 在浏览器中打开服务：http://localhost:8000/login
快速开始（Windows）
- 安装 Docker Desktop。
- 从最新 release 下载归档文件：https://github.com/exadel-inc/CompreFace/releases
- 解压归档文件。
- 运行 Docker。
- 打开命令提示符（在 Windows 搜索栏输入 cmd）。
- 打开你解压 zip 归档的文件夹（输入
cd path_of_the_folder，按回车）。
- 运行命令：
docker-compose up -d- 打开 http://localhost:8000/login
首次运行
- 服务启动后访问 http://localhost:8000/login 进入 Web 界面，可在 UI 面板中管理用户角色与访问权限，并创建/管理人脸识别服务（参见配图 3 仪表盘页、配图 6 服务页、配图 7 向导页）。
- 人脸识别、人脸验证、人脸检测、关键点检测等能力对应的界面示例见配图 2、配图 4、配图 5。
贡献者入门
README 提供 “Getting started for contributors” 链接，按该链接指引操作。
常见问题与注意事项
- 若机器不支持 AVX，可能无法正常运行，请先用
lscpu | grep avx确认。 - 默认 Web 访问端口为 8000（http://localhost:8000/login）。
- 支持 CPU 与 GPU 两种运行方式，并易于扩展；具体的模型选择、配置项、自定义构建、Kubernetes 配置、人脸数据迁移、匿名统计开关等，请查阅 README 中对应章节与官方文档（Configuration、Custom Builds、Kubernetes configuration、Face data migration、Gathering Anonymous Statistics、Installation Options）。
- 更多安装选项与部署方式参见官方 Installation Options 章节。
