face_recognition 人脸识别库

face_recognition 人脸识别库

face_recognition 是一个基于 Python 的简单易用人脸识别库，构建在 dlib 的深度学习人脸识别模型之上。它在 LFW 基准测试中达到了 99.38% 的准确率，并提供了简洁的 Python API 和命令行工具。

核心功能

• 人脸检测：快速定位图片中所有人脸的位置。
• 人脸特征点提取：获取眼睛、鼻子、嘴巴和下巴的轮廓坐标。
• 人脸识别：通过比较人脸编码来判断是否为同一人。
• 实时识别：结合 OpenCV 等库可实现摄像头实时人脸识别。

快速上手

安装依赖 dlib 和 cmake 后，通过 pip 安装：

pip3 install face_recognition

Python API 示例

检测人脸位置：

import face_recognition
image = face_recognition.load_image_file("your_file.jpg")
face_locations = face_recognition.face_locations(image)

比较两张人脸是否为同一人：

known_image = face_recognition.load_image_file("biden.jpg")
unknown_image = face_recognition.load_image_file("unknown.jpg")

biden_encoding = face_recognition.face_encodings(known_image)[0]
unknown_encoding = face_recognition.face_encodings(unknown_image)[0]

results = face_recognition.compare_faces([biden_encoding], unknown_encoding)

命令行工具

安装后会提供两个命令：

• face_recognition：在照片或文件夹中识别人脸。
• face_detection：检测照片中的人脸位置。

例如，识别未知图片中的人物：

face_recognition ./pictures_of_people_i_know/ ./unknown_pictures/

输出格式为 文件名,人物姓名，未匹配到的人脸标记为 unknown_person。

安装注意事项

• 官方支持 macOS 和 Linux，Windows 需参考社区指南。
• 需要预先安装 dlib 和 cmake。
• 在树莓派、Jetson Nano 等设备上也有安装教程。

适用场景

• 快速构建人脸识别原型
• 照片自动分类与整理
• 门禁或考勤系统demo
• 教学与计算机视觉入门

项目提供中文 README，社区活跃，是入门人脸识别的优秀选择。