Insightface 可谓是 ComfyUI 生态中不可或缺的核心组件。如果你曾使用过 IP-Adapter 或 InstantID，就会清楚它的关键作用——没有它，这些与人脸相关的工具根本无法正常运行。因此，能否顺利安装 Insightface，直接决定了后续工作流能否顺利搭建。

手动安装方法

首先来介绍手动安装的流程。整体步骤并不复杂，但有几个细节需要特别注意，一旦操作失误，很可能在某个报错环节卡住很长时间。

第一步：下载 InsightFace 文件

首先，打开以下 GitHub 仓库地址：
https://github.com/Gourieff/Assets/tree/main/Insightface

该仓库提供了多个版本的 InsightFace 文件，你需要根据自己使用的 Python 版本进行选择。例如，如果你的 Python 版本是 3.10，请下载对应的版本，切勿混淆。

第二步：检查 Python 版本

如何查看 Python 版本？进入 ComfyUI 的虚拟环境，双击图标打开终端，版本号就会直接显示在界面中。这一步很简单，但很多人容易跳过，导致下载了不匹配的文件，最终安装失败。

第三步：下载并安装

这里有两个关键要点：

• 选对路径：将刚才下载的文件，放入刚刚打开的 python.exe 同级目录中。注意，路径中不能包含中文字符，否则极有可能出现无法预料的错误。

• 进入 ComfyUI 根目录：打开终端，使用 cd 命令切换到 ComfyUI 的根目录，然后输入以下命令：

python.exe -m pip install insightface

如果你之前安装过但失败了，请先彻底卸载：

python.exe -m pip uninstall insightface

接着更新 pip 工具：

python.exe -m pip install -U pip

最后通过 whl 文件重新安装：

python.exe -m pip install insightface-0.7.3-cp311-cp311-win_amd64.whl

安装成功后，你会在 python_embeded 文件夹中看到 insightface 的相关文件，这表示已经正确安装。

秋叶启动器安装方法

如果你觉得手动安装的步骤比较繁琐，使用秋叶启动器会省心很多。直接按照下方截图中的步骤操作即可。万一秋叶启动器安装失败，也不必慌张，回头用手动方法补救一下就行，两条途径总有一条可以顺利走通。

以上就是 InsightFace 的完整安装流程，手动和自动两种方式都已为你整理清楚，你可以根据自己的习惯选择合适的方法。