Spaces:
Running
Running
|  | |
| # ComfyUI InstantID | |
| Unofficial implementation of [InstantID](https://github.com/InstantID/InstantID) for ComfyUI | |
|  | |
| + pose_ref | |
|  | |
| ## 项目介绍 | Info | |
| - 来自对[InstantID](https://github.com/InstantID/InstantID)的非官方实现 | |
| - 版本：V2.0 支持姿势参考图 | |
| <!--- | |
| 同时支持本地、huggingface hub模型，支持通用styler（也与 PhotoMaker Styler 通用） | |
| ---> | |
| ## 视频演示 | |
| V2.0 | |
| https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/assets/140084057/083c9e5e-06a0-4623-b5ac-05f7e85a74f2 | |
| V1.0 | |
| https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/assets/140084057/7295c0d7-1d1b-4044-aea3-8efa67047362 | |
| ## 节点说明 | Features | |
| - 基础模型加载 | base model loader | |
| - 📷ID Base Model Loader from hub 🤗：支持从 huggingface hub 自动下载模型，输入模型名称（如：wangqixun/YamerMIX_v8）即可 | |
| - 📷ID Base Model Loader locally：支持加载本地模型（需 SDXL 系列模型） | |
| - InsightFace 模型加载 | 📷InsightFace Loader | |
| - ：支持 CUDA 和 CPU | |
| - ID ControlNet 模型加载 | 📷ID ControlNet Loader | |
| - controlnet_path：ID ControlNet 模型地址 | |
| - Ipadapter_instantid 模型加载 | 📷Ipadapter_instantid Loader | |
| - Ipadapter_instantid_path：模型路径 | |
| - filename：模型名称 | |
| - 提示词 + 风格 | 📷ID Prompt_Styler | |
| - 与各种提示词（文本）输入（如肖像大师等）、styler、 Photomaker Prompt_Styler 兼容 | |
| - prompt、negative：正负提示词 | |
| - style_name：支持官方提供的8种风格 | |
| - (No style) | |
| - Watercolor | |
| - Film Noir | |
| - Neon | |
| - Jungle | |
| - Mars | |
| - Vibrant Color | |
| - Snow | |
| - Line art | |
| - InstantID 生成 | 📷InstantID Generation 🆕 | |
| - face_image：接入脸部参考图像 | |
| - pipe：接入模型 | |
| - insightface：接入 insightface 模型 🆕 | |
| - pose_image_optional（非必要）：接入姿势参考图像（注意：仅对面部周围姿势起效，与通常的 openpose 不同） | |
| - positivet、negative：正负提示词 | |
| - ip_adapter_scale：IPA 强度 | |
| - controlnet_conditioning_scale：ID Controlnet 强度 | |
| - step：步数，官方默认30步 | |
| - guidance_scale：提示词相关度，一般默认为5 | |
| - enhance_face_region：脸部增强选项 🆕 | |
| - seed：种子 | |
| ## 风格 | Styles | |
|  | |
| ## 安装 | Install | |
| - 推荐使用管理器 ComfyUI Manager 安装（On the Way） | |
| - 手动安装： | |
| 1. `cd custom_nodes` | |
| 2. `git clone https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID.git` | |
| 3. `cd custom_nodes/ComfyUI-InstantID` | |
| 4. `pip install -r requirements.txt` | |
| 5. 重启 ComfyUI | |
| ## 使用方法 | How to Use | |
| - 下载 [InstantID/ControlNetModel](https://huggingface.co/InstantX/InstantID/tree/main/ControlNetModel) 中的 config.json 和 diffusion_pytorch_model.safetensors ，将模型地址填入 📷ID ControlNet Loader 节点中（例如：ComfyUI/custom_nodes/ComfyUI-InstantID/checkpoints/controlnet） | |
| - 下载 [InstantID/ip-adapter](https://huggingface.co/InstantX/InstantID/tree/main) 中的 ip-adapter.bin ，将其地址填入 📷Ipadapter_instantid Loader 节点中（例如：ComfyUI/custom_nodes/ComfyUI-InstantID/checkpoints） | |
| - 下载 [DIAMONIK7777/antelopev2](https://huggingface.co/DIAMONIK7777/antelopev2/tree/main) 中的所有模型，将其放入 ComfyUI//custom_nodes/ComfyUI-InstantID/models/antelopev2 中 | |
| - 兼容性： CUDA11 支持默认安装的 onnxruntime-gpu（1.16.0），如果是 CUDA12 则需手动安装 onnxruntime-gpu==1.17.0 [地址](https://dev.azure.com/onnxruntime/onnxruntime/_artifacts/feed/onnxruntime-cuda-12/PyPI/onnxruntime-gpu/overview/1.17.0) | |
| ## 工作流 | Workflows | |
| V2.0 | |
| - [V2.0 InstantID_pose_ref + ArtGallery](https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/blob/main/INSTANTID%20WORKFLOWS/V2.0%20InstantID_pose_ref%20%2B%20ArtGallery%20%E3%80%90Zho%E3%80%91.json) | |
|  | |
| - [V2.0 自动下载 huggingface hub](https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/blob/main/INSTANTID%20WORKFLOWS/V2.0%20InstantID_fromhub_pose_ref%E3%80%90Zho%E3%80%91.json) | |
|  | |
| - [V2.0 InstantID_locally_pose_ref](https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/blob/main/INSTANTID%20WORKFLOWS/V2.0%20InstantID_locally_pose_ref%E3%80%90Zho%E3%80%91.json) | |
|  | |
| V1.0 工作流仅适用于V1.0 版本 | |
| - [V1.0 InstantID + ArtGallery](https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/blob/main/INSTANTID%20WORKFLOWS/V1.0%20InstantID%20%2B%20ArtGallery%E3%80%90Zho%E3%80%91.json) | |
|  | |
| - [V1.0 本地模型 locally](https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/blob/main/INSTANTID%20WORKFLOWS/V1.0%20InstantID_locally%E3%80%90Zho%E3%80%91.json) | |
|  | |
| - [V1.0 自动下载 huggingface hub](https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/blob/main/INSTANTID%20WORKFLOWS/V1.0%20InstantID_fromhub%E3%80%90Zho%E3%80%91.json) | |
|  | |
| ## 更新日志 | |
| - 20240124 | |
| 更新为 V2.0 ：新增姿势参考图、优化代码 | |
| 修复 insightfaceloader 冲突问题 | |
| 修复 onnxruntime-gpu 版本兼容性的问题 | |
| - 20240123 | |
| V1.0 上线：同时支持本地、huggingface hub托管模型，支持8种风格 | |
| - 20240122 | |
| 创建项目 | |
| ## 速度实测 | Speed | |
| - V1.0 | |
| - A100 50步 14s | |
|  | |
| ## Stars | |
| [](https://star-history.com/#ZHO-ZHO-ZHO/ComfyUI-InstantID&Date) | |
| ## 关于我 | About me | |
| 📬 **联系我**： | |
| - 邮箱：zhozho3965@gmail.com | |
| - QQ 群：839821928 | |
| 🔗 **社交媒体**： | |
| - 个人页：[-Zho-](https://jike.city/zho) | |
| - Bilibili：[我的B站主页](https://space.bilibili.com/484366804) | |
| - X（Twitter）：[我的Twitter](https://twitter.com/ZHOZHO672070) | |
| - 小红书：[我的小红书主页](https://www.xiaohongshu.com/user/profile/63f11530000000001001e0c8?xhsshare=CopyLink&appuid=63f11530000000001001e0c8&apptime=1690528872) | |
| 💡 **支持我**： | |
| - B站：[B站充电](https://space.bilibili.com/484366804) | |
| - 爱发电：[为我充电](https://afdian.net/a/ZHOZHO) | |
| ## Credits | |
| [InstantID](https://github.com/InstantID/InstantID) | |
| 📷InsightFace Loader 代码修改自 [ComfyUI_IPAdapter_plus](https://github.com/cubiq/ComfyUI_IPAdapter_plus)，感谢 [@cubiq](https://github.com/cubiq)！ | |
| 感谢 [@hidecloud](https://twitter.com/hidecloud) 对 onnxruntime 版本兼容性的测试与反馈！ | |
| 感谢 [esheep](https://www.esheep.com/) 技术人员对节点冲突问题的反馈！ | |