ComfyUI-InstantID 的安装和配置教程

1. 项目基础介绍和主要编程语言

ComfyUI-InstantID 是一个开源项目，它为 Instant ID 提供了一个薄薄的定制节点包装器，适用于 ComfyUI。Instant ID 是一种无需微调即可实现身份保留生成的最新技术，只需单张图片即可支持各种下游任务。该项目使用 Python 作为主要编程语言。

2. 项目使用的关键技术和框架

该项目使用了以下关键技术和框架：

• Instant ID: 一种新的无需微调的身份保留生成技术。
• ComfyUI: 一个用户友好的图形界面，用于构建和测试各种 AI 管道。
• Huggingface Hub: 用于下载预训练模型的平台。

3. 项目安装和配置的准备工作及详细步骤

准备工作

在开始安装之前，请确保您的系统中已经安装了以下依赖：

• Python 3.7 或更高版本
• pip（Python 包管理器）
• Git（用于克隆项目仓库）

安装步骤

1. 克隆项目仓库

   打开命令行，导航到您的项目目录，然后运行以下命令克隆仓库：

   cd ComfyUI/custom_nodes/
   git clone https://github.com/huxiuhan/ComfyUI-InstantID.git
   

2. 安装依赖

   在克隆完仓库后，使用 pip 安装 requirements.txt 文件中列出的依赖项：

   pip install -r requirements.txt
   

3. 下载模型

   从 Huggingface Hub 下载所需的模型文件。如果无法访问 Huggingface，可以使用 hf-mirror 来下载模型。以下是使用 Huggingface Hub 下载模型的示例代码：

   from huggingface_hub import hf_hub_download
   
   hf_hub_download(
       repo_id="InstantX/InstantID",
       filename="ControlNetModel/config.json",
       local_dir="./checkpoints"
   )
   
   hf_hub_download(
       repo_id="InstantX/InstantID",
       filename="ControlNetModel/diffusion_pytorch_model.safetensors",
       local_dir="./checkpoints"
   )
   
   hf_hub_download(
       repo_id="InstantX/InstantID",
       filename="ip-adapter.bin",
       local_dir="./checkpoints"
   )
   

   如果需要下载人脸编码器模型，则需要手动下载并放置在 models/antelopev2 目录下。

4. 组织文件结构

   下载完所有模型后，确保文件夹结构如下：

   .
   ├── models
   ├── checkpoints
   ├── ip_adapter
   ├── pipeline_stable_diffusion_xl_instantid.py
   └── README.md
   

5. 使用 ComfyUI

   将下载的模型和自定义节点集成到 ComfyUI 中，按照 ComfyUI 的指南进行操作。

以上就是 ComfyUI-InstantID 的安装和配置指南。按照以上步骤操作，您应该能够成功安装并开始使用该项目。