包安装

相关源文件

• requirements.txt
• requirements_dev.txt
• setup.py

本文档提供了安装 face_recognition Python 包的详细说明。它涵盖了通过 PyPI 进行的标准安装、从源代码安装以及处理依赖项的步骤，并特别关注可能难以安装的 dlib。

有关基于 Docker 的安装，请参阅 Docker Setup。有关特定于 Raspberry Pi 的安装，请参阅 Raspberry Pi Setup。

安装方法概述

安装选项图

来源： setup.py12-18 requirements.txt1-6

标准 PyPI 安装

安装 face_recognition 库的推荐方法是通过 pip 使用 PyPI。

此命令将安装该包的最新稳定版本以及所有必需的依赖项。

来源： setup.py25-27

依赖项

如 setup 和 requirements 文件所述，face_recognition 包需要几个依赖项。

依赖项	版本	目的
face_recognition_models	>=0.3.0	用于人脸检测和识别的预训练模型
dlib	>=19.7	核心计算机视觉和机器学习功能
NumPy	*	数值计算和数组操作
Pillow	*	图像处理功能
Click	>=6.0	命令行界面功能

来源： setup.py12-18 requirements.txt1-6

软件包组件和依赖流

来源： setup.py12-18 setup.py33-45

安装 dlib

dlib 库是最难安装的依赖项，因为它需要使用 C++ 和 CMake 进行编译。以下是特定于平台的安装说明：

在 Ubuntu/Debian 上

在 macOS 上

在 Windows 上

在 Windows 上，您需要安装 Visual Studio 并配备 C++ 开发工具。或者，您可以尝试查找预编译的 wheel。

注意：上面的 wheel URL 是一个示例，可能需要根据您的 Python 版本和系统架构进行调整。

来源： setup.py15 requirements.txt3

从源代码安装

要安装最新的开发版本，请

1. 克隆仓库

2. 导航到目录

3. 安装包

这将以开发模式安装该软件包，创建指向源代码的链接，以便对代码的更改会立即生效，而无需重新安装。

来源： setup.py25-64

为开发安装

如果您打算为 face_recognition 的开发做出贡献，请

1. 按照上述说明克隆存储库

2. 安装开发依赖

3. 以开发模式安装包

来源： requirements_dev.txt1-15 setup.py20-23

验证安装

安装后，您可以通过以下方式验证 face_recognition 是否已正确安装：

1. 在 Python 中导入它

2. 测试命令行工具

命令行工具是通过 setup.py 中定义的入口点安装的，它们提供了对库功能的便捷访问，无需编写 Python 代码。

来源： setup.py40-45

疑难解答常见的安装问题

dlib 安装问题

如果您在安装 dlib 时遇到问题，请

1. 找不到 CMake：使用系统的包管理器（apt、brew 等）安装 CMake。
2. 编译器错误：确保您已安装并正确配置了 C++ 编译器。
3. 编译期间内存不足：如果在编译 dlib 时您的系统内存不足，请尝试：
   • 增加交换空间
   • 使用适用于您平台的预编译 wheel（如果可用）。
   • 使用更少的并行作业进行编译：DLIB_NO_GUI_SUPPORT=YES pip install dlib --no-cache-dir

缺少依赖项

如果您在导入 face_recognition 时看到有关缺少依赖项的错误，请确保所有必需的包都已安装。

版本冲突

如果您遇到软件包之间的版本冲突，请考虑使用虚拟环境。

这将创建一个隔离的环境，您可以在其中安装软件包而不会影响系统范围的 Python 安装。

来源： requirements.txt1-6