【人像识别】face_recognition库windows快速安装教程

张开发
2026/4/21 3:33:35 15 分钟阅读

分享文章

【人像识别】face_recognition库windows快速安装教程
1 face_recognition介绍face_recognition是世界上最简洁的人脸识别库可以使用Python和命令行工具提取、识别、操作人脸。face_recognition的人脸识别是基于业内领先的C开源库dlib中的深度学习模型用Labeled Faces in the Wild人脸数据集进行测试有高达99.38%的准确率。2 安装2.1 太长不看版(直接根据步骤安装即可)先确认使用的python版本python--version安装CMake库pipinstallCMake由于dlib库安装文件缺少版本号因此需要根据python版本选择对应版本通过下载whl文件进行安装。版本关系可见仓库。pipinstalldlib whl文件路径pipinstallnumpy1.26.4 pipinstallface_recognition pipinstallsetuptools82.0.0# setuptools从82.0.0版本开始移除pipinstallgithttps://github.com/ageitgey/face_recognition_models验证是否安装成功importface_recognitionprint(face_recognition import successfully.)2.2 详细纠错版一开始我就直接安装face_recognition结果在安装dlib过程中就报错原因dlib的下载链接中找不到对应版本需要找到与python版本对应的dlib解决根据python版本下载whl文件再进行pip安装。版本关系可见仓库。pipinstallwhl文件路径face_recognition安装成功后打算用起来。然而Pleaseinstallface_recognition_modelswith thiscommandbefore usingface_recognition:pipinstallgithttps://github.com/ageitgey/face_recognition_models这里就根据提示安装就好了。但是有时候setuptools版本过高会导致库下载失败因为setuptools从 82.0.0 版本开始移除了pkg_resources模块而老版本如81.0.0还保留着它。解决安装81.0.0版本的setuptoolsface_recognition和face_recognition_models都下好啦又准备用起来的时候…RuntimeError: Unsupported image type, must be 8bit gray or RGB image.原因这个问题通常与numpy版本有关因为face_recognition底层依赖与dlib而dlib对numpy数组的格式有严格要求。当使用较新版本的numpy如2.0.0时可能会产生数据类型不兼容的情况导致dlib无法正确识别图像格式。解决将numpy降级到1.26.4版本

更多文章