Insightface的常见安装问题解决办法

在使用FACEID时很多webui，comfyUI的用户，如果要使用脸部一致性，换脸模型（reactor，facefusion，FaceID）的都会需要安装一个叫Insightface的包。这个包安装经常会遇到一些问题。下面基于是总结的安装步骤。

InsightFace 简介

InsightFace 是一款开源的 2D 和 3D 深度人脸分析工具箱，支持各种流行的 AI 框架，例如 PaddlePaddle、PyTorch 和 ONNX。它提供了高效、准确的人脸检测、识别和对齐算法，并针对训练和部署进行了优化。

InsightFace 的主要功能包括：

• 人脸检测： 从图像或视频中准确检测人脸。
• 人脸识别： 将人脸图像与已知数据库中的图像进行匹配以识别身份。
• 人脸对齐： 将人脸图像中的关键点对齐到标准位置。

ComfyUI 中的常用与脸部有关的插件比如FaceID, Reactor, InstantID, PuLID 都需要InsightFace作为底层的依赖。但我们使用时经常会遇到以下类似的错误。

Insightface的安装

在windows环境通过pip方式直接安装insightface经常发生下面的错误。在linux环境可能会简单一些。

这类问题都是因为Insightface安装需要VC环境编译，很多用户对此不熟悉。因此可以直接通过轮子文件安装。先通过下面命令确定自己python的版本，一般主流的是3.10或者3.11，查看python版本。

python_embeded\python.exe -V

然后

安装版本对应的轮子文件，我这里使用的3.10版本的python，文章下面提供了文件包

python_embeded\python.exe -m pip install insightface-0.7.3-cp310-cp310-win_amd64.whl

轮子文件地址

一般这样insightface已经安装好了。

但是对于有些用户，可能需要统一安装onnxruntime和onnxruntime-gpu的版本。一般不建议安装最新版本。1.14.-1.16的版本都可以。

可以先卸载模型

python_embeded\python.exe -m pip uninstall onnxruntime onnxruntime-gpu

安装onnxruntime和onnxruntime-gpu的指定版本

python_embeded\python.exe -m pip install onnxruntime==1.16.3 onnxruntime-gpu=1.16.3

insightface模型的安装

下面需要安装insightface需要的模型。faceid，reactor用的是buffalo的模型， instantid和pulid用的是antelopev2。如果你网络可以访问外网，那就可以直接下载这些模型，位置在

ComfyUI\models\insightface\models\buffalo_l

ComfyUI\models\insightface\models\antelopev2

之后就应该可以正常使用insightface了，需要注意的是insightface不是全开源的license，商用一定要谨慎。