{"id":23233326,"url":"https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID","last_synced_at":"2025-08-19T18:31:43.129Z","repository":{"id":218539256,"uuid":"746667927","full_name":"ZHO-ZHO-ZHO/ComfyUI-InstantID","owner":"ZHO-ZHO-ZHO","description":"Unofficial implementation of InstantID for ComfyUI","archived":false,"fork":false,"pushed_at":"2024-05-22T13:57:55.000Z","size":51,"stargazers_count":1363,"open_issues_count":124,"forks_count":79,"subscribers_count":20,"default_branch":"main","last_synced_at":"2024-12-15T00:05:37.372Z","etag":null,"topics":["comfyui","stable-diffusion"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ZHO-ZHO-ZHO.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":"https://afdian.net/a/ZHOZHO"}},"created_at":"2024-01-22T13:26:40.000Z","updated_at":"2024-12-14T03:49:11.000Z","dependencies_parsed_at":"2024-02-04T13:47:00.980Z","dependency_job_id":"70651b24-5012-4251-aa1f-6f01b9435ca1","html_url":"https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID","commit_stats":null,"previous_names":["zho-zho-zho/comfyui-instantid"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZHO-ZHO-ZHO%2FComfyUI-InstantID","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZHO-ZHO-ZHO%2FComfyUI-InstantID/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZHO-ZHO-ZHO%2FComfyUI-InstantID/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZHO-ZHO-ZHO%2FComfyUI-InstantID/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ZHO-ZHO-ZHO","download_url":"https://codeload.github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230367780,"owners_count":18215325,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["comfyui","stable-diffusion"],"created_at":"2024-12-19T03:01:15.596Z","updated_at":"2024-12-19T03:01:44.696Z","avatar_url":"https://github.com/ZHO-ZHO-ZHO.png","language":"Python","funding_links":["https://afdian.net/a/ZHOZHO"],"categories":["All Workflows Sorted by GitHub Stars","Workflows (3395) sorted by GitHub Stars"],"sub_categories":[],"readme":"\n![ISID_](https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/assets/140084057/01393483-3145-4691-9daa-7ce9035c9bd0)\n\n\n# ComfyUI InstantID\n\nUnofficial implementation of [InstantID](https://github.com/InstantID/InstantID) for ComfyUI\n\n![Dingtalk_20240123182131](https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/assets/140084057/7a99b32c-b4a2-4c46-acb0-f796fc46f9ee)\n\n+ pose_ref\n\n![Dingtalk_20240124232946](https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/assets/140084057/caa60456-f2d8-4315-864b-659a9e7cea89)\n\n\n## 项目介绍 | Info\n\n- 来自对[InstantID](https://github.com/InstantID/InstantID)的非官方实现\n  \n- 版本：V2.0 支持姿势参考图\n\n\u003c!---\n  同时支持本地、huggingface hub模型，支持通用styler（也与 PhotoMaker Styler 通用）\n---\u003e\n\n## 视频演示\n\nV2.0\n\n\nhttps://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/assets/140084057/083c9e5e-06a0-4623-b5ac-05f7e85a74f2\n\n\nV1.0\n\nhttps://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/assets/140084057/7295c0d7-1d1b-4044-aea3-8efa67047362\n\n\n\n## 节点说明 | Features\n\n- 基础模型加载 | base model loader\n    - 📷ID Base Model Loader from hub 🤗：支持从 huggingface hub 自动下载模型，输入模型名称（如：wangqixun/YamerMIX_v8）即可\n    - 📷ID Base Model Loader locally：支持加载本地模型（需 SDXL 系列模型）\n\n- InsightFace 模型加载 | 📷InsightFace Loader\n    - ：支持 CUDA 和 CPU\n\n- ID ControlNet 模型加载 | 📷ID ControlNet Loader\n    - controlnet_path：ID ControlNet 模型地址\n\n- Ipadapter_instantid 模型加载 | 📷Ipadapter_instantid Loader\n    - Ipadapter_instantid_path：模型路径\n    - filename：模型名称\n\n - 提示词 + 风格 | 📷ID Prompt_Styler\n    - 与各种提示词（文本）输入（如肖像大师等）、styler、 Photomaker Prompt_Styler 兼容\n    - prompt、negative：正负提示词\n    - style_name：支持官方提供的8种风格\n        - (No style)\n        - Watercolor\n        - Film Noir\n        - Neon\n        - Jungle\n        - Mars\n        - Vibrant Color\n        - Snow\n        - Line art\n\n- InstantID 生成 | 📷InstantID Generation 🆕\n    - face_image：接入脸部参考图像\n    - pipe：接入模型\n    - insightface：接入 insightface 模型 🆕\n    - pose_image_optional（非必要）：接入姿势参考图像（注意：仅对面部周围姿势起效，与通常的 openpose 不同）\n    - positivet、negative：正负提示词\n    - ip_adapter_scale：IPA 强度\n    - controlnet_conditioning_scale：ID Controlnet 强度\n    - step：步数，官方默认30步\n    - guidance_scale：提示词相关度，一般默认为5\n    - enhance_face_region：脸部增强选项 🆕\n    - seed：种子\n\n\n## 风格 | Styles\n\n![ISID_STYLE](https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/assets/140084057/142bda7a-798b-46b3-aa69-1b88701c8311)\n\n\n\n## 安装 | Install\n\n\n- 推荐使用管理器 ComfyUI Manager 安装（On the Way）\n\n\n- 手动安装：\n    1. `cd custom_nodes`\n    2. `git clone https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID.git`\n    3. `cd custom_nodes/ComfyUI-InstantID`\n    4. `pip install -r requirements.txt`\n    5. 重启 ComfyUI\n\n\n## 使用方法 | How to Use\n\n- 下载 [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）\n\n- 下载 [InstantID/ip-adapter](https://huggingface.co/InstantX/InstantID/tree/main) 中的 ip-adapter.bin ，将其地址填入 📷Ipadapter_instantid Loader 节点中（例如：ComfyUI/custom_nodes/ComfyUI-InstantID/checkpoints）\n\n- 下载 [DIAMONIK7777/antelopev2](https://huggingface.co/DIAMONIK7777/antelopev2/tree/main) 中的所有模型，将其放入 ComfyUI//custom_nodes/ComfyUI-InstantID/models/antelopev2 中\n\n- 兼容性： 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)\n\n  \n## 工作流 | Workflows\n\nV2.0\n\n- [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)\n\n  ![Dingtalk_20240124232833](https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/assets/140084057/99be9592-775d-4c33-bafc-5bd5c95a7222)\n\n\n- [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)\n\n  ![Dingtalk_20240124230145](https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/assets/140084057/95c4a1dd-864d-4a46-8c45-a48866aef29f)\n\n\n- [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)\n\n  ![Dingtalk_20240124230609](https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/assets/140084057/d4c22389-f853-44bd-9ea2-568b2ac7ed06)\n\n\nV1.0 工作流仅适用于V1.0 版本\n\n- [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)\n\n\n  ![Dingtalk_20240123182440](https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/assets/140084057/c6ee25bf-a528-4d78-9b35-f5b0d0303601)\n\n\n- [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)\n\n  ![Dingtalk_20240123175624](https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/assets/140084057/459bfede-59e8-4d8d-941c-a950c4827c49)\n\n\n- [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)\n\n  ![Dingtalk_20240123174950](https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/assets/140084057/50133961-1752-4ec8-ac0b-068d998b8534)\n\n\n\n\n## 更新日志\n\n- 20240124\n\n  更新为 V2.0 ：新增姿势参考图、优化代码\n\n  修复 insightfaceloader 冲突问题\n\n  修复 onnxruntime-gpu 版本兼容性的问题\n\n- 20240123\n\n  V1.0 上线：同时支持本地、huggingface hub托管模型，支持8种风格\n\n- 20240122\n\n  创建项目\n\n\n## 速度实测 | Speed\n\n- V1.0 \n\n    - A100 50步 14s\n\n    ![image](https://github.com/ZHO-ZHO-ZHO/ComfyUI-InstantID/assets/140084057/dc535e67-3f56-4faf-be81-621b84bb6ee2)\n\n\n\n## Stars \n\n[![Star History Chart](https://api.star-history.com/svg?repos=ZHO-ZHO-ZHO/ComfyUI-InstantID\u0026type=Date)](https://star-history.com/#ZHO-ZHO-ZHO/ComfyUI-InstantID\u0026Date)\n\n\n## 关于我 | About me\n\n📬 **联系我**：\n- 邮箱：zhozho3965@gmail.com\n- QQ 群：839821928\n\n🔗 **社交媒体**：\n- 个人页：[-Zho-](https://jike.city/zho)\n- Bilibili：[我的B站主页](https://space.bilibili.com/484366804)\n- X（Twitter）：[我的Twitter](https://twitter.com/ZHOZHO672070)\n- 小红书：[我的小红书主页](https://www.xiaohongshu.com/user/profile/63f11530000000001001e0c8?xhsshare=CopyLink\u0026appuid=63f11530000000001001e0c8\u0026apptime=1690528872)\n\n💡 **支持我**：\n- B站：[B站充电](https://space.bilibili.com/484366804)\n- 爱发电：[为我充电](https://afdian.net/a/ZHOZHO)\n\n\n## Credits\n\n[InstantID](https://github.com/InstantID/InstantID)\n\n📷InsightFace Loader 代码修改自 [ComfyUI_IPAdapter_plus](https://github.com/cubiq/ComfyUI_IPAdapter_plus)，感谢 [@cubiq](https://github.com/cubiq)！\n\n感谢 [@hidecloud](https://twitter.com/hidecloud) 对 onnxruntime 版本兼容性的测试与反馈！\n\n感谢 [esheep](https://www.esheep.com/) 技术人员对节点冲突问题的反馈！\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZHO-ZHO-ZHO%2FComfyUI-InstantID","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FZHO-ZHO-ZHO%2FComfyUI-InstantID","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZHO-ZHO-ZHO%2FComfyUI-InstantID/lists"}