ComfyUI-InstantID

环境要求

• 已安装并可正常运行的 ComfyUI
• Python 环境及 pip
• 一个 SDXL 系列基础模型
• CUDA11 或 CUDA12 环境（也可用 CPU 跑 InsightFace）

安装与启动步骤

1. 1进入节点目录

   打开终端，切换到 ComfyUI 根目录下的 custom_nodes 文件夹，后续插件都装在这里。

   cd custom_nodes

   复制

2. 2克隆插件仓库

   在 custom_nodes 目录下克隆 ComfyUI-InstantID 仓库，需保证网络可访问 GitHub。

   git clone https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID.git

   复制

3. 3安装依赖

   进入插件目录，安装 requirements.txt 中的 Python 依赖，建议在 ComfyUI 所用环境中执行。

   cd custom_nodes/ComfyUI-InstantID
   pip install -r requirements.txt

   复制

4. 4重启 ComfyUI

   依赖装完后重启 ComfyUI，让自定义节点被加载，之后才能在工作流里看到 InstantID 节点。

5. 5下载 ControlNet 模型

   从 InstantX/InstantID 的 ControlNetModel 下载 config.json 和 diffusion_pytorch_model.safetensors，放入 checkpoints/controlnet。

6. 6下载 ip-adapter 模型

   从 InstantX/InstantID 下载 ip-adapter.bin，放入插件 checkpoints 目录，路径稍后填入 Ipadapter_instantid Loader 节点。

7. 7下载人脸识别模型

   从 DIAMONIK7777/antelopev2 下载全部模型，放入 ComfyUI/custom_nodes/ComfyUI-InstantID/models/antelopev2。

关键配置

如何确认成功

重启 ComfyUI 后，在节点列表中找到 ID Base Model Loader、InstantID Generation 等 InstantID 节点即表示安装成功。

常见问题

注意事项

• InsightFace Loader 支持 CUDA 和 CPU，无 GPU 时可选 CPU。
• InstantID 生成节点支持接入可选姿势参考图 pose_image_optional。
• Prompt_Styler 支持官方 8 种风格，且与 PhotoMaker Prompt_Styler 通用。
• README 未给出模型的下载命令，需自行从 Hugging Face 页面获取文件。