[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-71132":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":14,"forks30d":14,"starsTrendScore":18,"compositeScore":19,"rankGlobal":8,"rankLanguage":8,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":21,"hasPages":21,"topics":23,"createdAt":8,"pushedAt":8,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":14,"starSnapshotCount":14,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},71132,"ComfyUI_IPAdapter_plus","cubiq\u002FComfyUI_IPAdapter_plus","cubiq",null,"Python",6017,464,44,204,0,12,25,65,36,39,"GNU General Public License v3.0",false,"main",[],"2026-06-12 02:02:48","# ComfyUI IPAdapter plus\n[ComfyUI](https:\u002F\u002Fgithub.com\u002Fcomfyanonymous\u002FComfyUI) reference implementation for [IPAdapter](https:\u002F\u002Fgithub.com\u002Ftencent-ailab\u002FIP-Adapter\u002F) models.\n\nThe IPAdapter are very powerful models for image-to-image conditioning. The subject or even just the style of the reference image(s) can be easily transferred to a generation. Think of it as a 1-image lora.\n\n> [!IMPORTANT]  \n> **2025.04.14** - I do not use ComfyUI as my main way to interact with Gen AI anymore as a result I'm setting the repository in \"maintenance only\" mode. If there are crucial updates or PRs I might still consider merging them but I do not plan any consistent work on this repo.\n\n## Example workflows\n\nThe [examples directory](.\u002Fexamples\u002F) has many workflows that cover all IPAdapter functionalities.\n\n![IPAdapter Example workflow](.\u002Fexamples\u002Fdemo_workflow.jpg)\n\n## Video Tutorials\n\n\u003Ca href=\"https:\u002F\u002Fyoutu.be\u002F_JzDcgKgghY\" target=\"_blank\">\n \u003Cimg src=\"https:\u002F\u002Fimg.youtube.com\u002Fvi\u002F_JzDcgKgghY\u002Fhqdefault.jpg\" alt=\"Watch the video\" \u002F>\n\u003C\u002Fa>\n\n- **:star: [New IPAdapter features](https:\u002F\u002Fyoutu.be\u002F_JzDcgKgghY)**\n- **:art: [IPAdapter Style and Composition](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=czcgJnoDVd4)**\n\nThe following videos are about the previous version of IPAdapter, but they still contain valuable information.\n\n:nerd_face: [Basic usage video](https:\u002F\u002Fyoutu.be\u002F7m9ZZFU3HWo), :rocket: [Advanced features video](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=mJQ62ly7jrg), :japanese_goblin: [Attention Masking video](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=vqG1VXKteQg), :movie_camera: [Animation Features video](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=ddYbhv3WgWw)\n\n## Installation\n\nDownload or git clone this repository inside `ComfyUI\u002Fcustom_nodes\u002F` directory or use the Manager. IPAdapter always requires the latest version of ComfyUI. If something doesn't work be sure to upgrade. Beware that the automatic update of the manager sometimes doesn't work and you may need to upgrade manually.\n\nThere's now a *Unified Model Loader*, for it to work you need to name the files exactly as described below. The legacy loaders work with any file name but you have to select them manually. The models can be placed into sub-directories.\n\nRemember you can also use any custom location setting an `ipadapter` entry in the `extra_model_paths.yaml` file.\n\n- `\u002FComfyUI\u002Fmodels\u002Fclip_vision`\n    - [CLIP-ViT-H-14-laion2B-s32B-b79K.safetensors](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter\u002Fresolve\u002Fmain\u002Fmodels\u002Fimage_encoder\u002Fmodel.safetensors), download and rename\n    - [CLIP-ViT-bigG-14-laion2B-39B-b160k.safetensors](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter\u002Fresolve\u002Fmain\u002Fsdxl_models\u002Fimage_encoder\u002Fmodel.safetensors), download and rename\n    - [clip-vit-large-patch14-336.bin](https:\u002F\u002Fhuggingface.co\u002FKwai-Kolors\u002FKolors-IP-Adapter-Plus\u002Fresolve\u002Fmain\u002Fimage_encoder\u002Fpytorch_model.bin), download and rename only for Kolors models\n- `\u002FComfyUI\u002Fmodels\u002Fipadapter`, create it if not present\n    - [ip-adapter_sd15.safetensors](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter\u002Fresolve\u002Fmain\u002Fmodels\u002Fip-adapter_sd15.safetensors), Basic model, average strength\n    - [ip-adapter_sd15_light_v11.bin](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter\u002Fresolve\u002Fmain\u002Fmodels\u002Fip-adapter_sd15_light_v11.bin), Light impact model\n    - [ip-adapter-plus_sd15.safetensors](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter\u002Fresolve\u002Fmain\u002Fmodels\u002Fip-adapter-plus_sd15.safetensors), Plus model, very strong\n    - [ip-adapter-plus-face_sd15.safetensors](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter\u002Fresolve\u002Fmain\u002Fmodels\u002Fip-adapter-plus-face_sd15.safetensors), Face model, portraits\n    - [ip-adapter-full-face_sd15.safetensors](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter\u002Fresolve\u002Fmain\u002Fmodels\u002Fip-adapter-full-face_sd15.safetensors), Stronger face model, not necessarily better\n    - [ip-adapter_sd15_vit-G.safetensors](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter\u002Fresolve\u002Fmain\u002Fmodels\u002Fip-adapter_sd15_vit-G.safetensors), Base model, **requires bigG clip vision encoder**\n    - [ip-adapter_sdxl_vit-h.safetensors](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter\u002Fresolve\u002Fmain\u002Fsdxl_models\u002Fip-adapter_sdxl_vit-h.safetensors), SDXL model\n    - [ip-adapter-plus_sdxl_vit-h.safetensors](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter\u002Fresolve\u002Fmain\u002Fsdxl_models\u002Fip-adapter-plus_sdxl_vit-h.safetensors), SDXL plus model\n    - [ip-adapter-plus-face_sdxl_vit-h.safetensors](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter\u002Fresolve\u002Fmain\u002Fsdxl_models\u002Fip-adapter-plus-face_sdxl_vit-h.safetensors), SDXL face model\n    - [ip-adapter_sdxl.safetensors](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter\u002Fresolve\u002Fmain\u002Fsdxl_models\u002Fip-adapter_sdxl.safetensors), vit-G SDXL model, **requires bigG clip vision encoder**\n    - **Deprecated** [ip-adapter_sd15_light.safetensors](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter\u002Fresolve\u002Fmain\u002Fmodels\u002Fip-adapter_sd15_light.safetensors), v1.0 Light impact model\n\n**FaceID** models require `insightface`, you need to install it in your ComfyUI environment. Check [this issue](https:\u002F\u002Fgithub.com\u002Fcubiq\u002FComfyUI_IPAdapter_plus\u002Fissues\u002F162) for help. Remember that most FaceID models also need a LoRA.\n\nFor the Unified Loader to work the files need to be named exactly as shown in the list below.\n\n- `\u002FComfyUI\u002Fmodels\u002Fipadapter`\n    - [ip-adapter-faceid_sd15.bin](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter-FaceID\u002Fresolve\u002Fmain\u002Fip-adapter-faceid_sd15.bin), base FaceID model\n    - [ip-adapter-faceid-plusv2_sd15.bin](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter-FaceID\u002Fresolve\u002Fmain\u002Fip-adapter-faceid-plusv2_sd15.bin), FaceID plus v2\n    - [ip-adapter-faceid-portrait-v11_sd15.bin](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter-FaceID\u002Fresolve\u002Fmain\u002Fip-adapter-faceid-portrait-v11_sd15.bin), text prompt style transfer for portraits\n    - [ip-adapter-faceid_sdxl.bin](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter-FaceID\u002Fresolve\u002Fmain\u002Fip-adapter-faceid_sdxl.bin), SDXL base FaceID\n    - [ip-adapter-faceid-plusv2_sdxl.bin](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter-FaceID\u002Fresolve\u002Fmain\u002Fip-adapter-faceid-plusv2_sdxl.bin), SDXL plus v2\n    - [ip-adapter-faceid-portrait_sdxl.bin](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter-FaceID\u002Fresolve\u002Fmain\u002Fip-adapter-faceid-portrait_sdxl.bin), SDXL text prompt style transfer\n    - [ip-adapter-faceid-portrait_sdxl_unnorm.bin](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter-FaceID\u002Fresolve\u002Fmain\u002Fip-adapter-faceid-portrait_sdxl_unnorm.bin), very strong style transfer SDXL only\n    - **Deprecated** [ip-adapter-faceid-plus_sd15.bin](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter-FaceID\u002Fresolve\u002Fmain\u002Fip-adapter-faceid-plus_sd15.bin), FaceID plus v1 \n    - **Deprecated** [ip-adapter-faceid-portrait_sd15.bin](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter-FaceID\u002Fresolve\u002Fmain\u002Fip-adapter-faceid-portrait_sd15.bin), v1 of the portrait model\n\nMost FaceID models require a LoRA. If you use the `IPAdapter Unified Loader FaceID` it will be loaded automatically if you follow the naming convention. Otherwise you have to load them manually, be careful each FaceID model has to be paired with its own specific LoRA.\n\n- `\u002FComfyUI\u002Fmodels\u002Floras`\n    - [ip-adapter-faceid_sd15_lora.safetensors](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter-FaceID\u002Fresolve\u002Fmain\u002Fip-adapter-faceid_sd15_lora.safetensors)\n    - [ip-adapter-faceid-plusv2_sd15_lora.safetensors](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter-FaceID\u002Fresolve\u002Fmain\u002Fip-adapter-faceid-plusv2_sd15_lora.safetensors)\n    - [ip-adapter-faceid_sdxl_lora.safetensors](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter-FaceID\u002Fresolve\u002Fmain\u002Fip-adapter-faceid_sdxl_lora.safetensors), SDXL FaceID LoRA\n    - [ip-adapter-faceid-plusv2_sdxl_lora.safetensors](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter-FaceID\u002Fresolve\u002Fmain\u002Fip-adapter-faceid-plusv2_sdxl_lora.safetensors), SDXL plus v2 LoRA\n    - **Deprecated** [ip-adapter-faceid-plus_sd15_lora.safetensors](https:\u002F\u002Fhuggingface.co\u002Fh94\u002FIP-Adapter-FaceID\u002Fresolve\u002Fmain\u002Fip-adapter-faceid-plus_sd15_lora.safetensors), LoRA for the deprecated FaceID plus v1 model\n\nAll models can be found on [huggingface](https:\u002F\u002Fhuggingface.co\u002Fh94).\n\n### Community's models\n\nThe community has baked some interesting IPAdapter models.\n\n- `\u002FComfyUI\u002Fmodels\u002Fipadapter`\n    - [ip_plus_composition_sd15.safetensors](https:\u002F\u002Fhuggingface.co\u002Fostris\u002Fip-composition-adapter\u002Fresolve\u002Fmain\u002Fip_plus_composition_sd15.safetensors), general composition ignoring style and content, more about it [here](https:\u002F\u002Fhuggingface.co\u002Fostris\u002Fip-composition-adapter)\n    - [ip_plus_composition_sdxl.safetensors](https:\u002F\u002Fhuggingface.co\u002Fostris\u002Fip-composition-adapter\u002Fresolve\u002Fmain\u002Fip_plus_composition_sdxl.safetensors), SDXL version\n    - [Kolors-IP-Adapter-Plus.bin](https:\u002F\u002Fhuggingface.co\u002FKwai-Kolors\u002FKolors-IP-Adapter-Plus\u002Fresolve\u002Fmain\u002Fip_adapter_plus_general.bin?download=true), IPAdapter Plus for Kolors model\n    - [Kolors-IP-Adapter-FaceID-Plus.bin](https:\u002F\u002Fhuggingface.co\u002FKwai-Kolors\u002FKolors-IP-Adapter-FaceID-Plus\u002Fresolve\u002Fmain\u002Fipa-faceid-plus.bin?download=true), IPAdapter FaceIDv2 for Kolors model. **Note:** Kolors is trained on InsightFace  **antelopev2** model, you need to [manually download it](https:\u002F\u002Fhuggingface.co\u002FMonsterMMORPG\u002Ftools\u002Ftree\u002Fmain) and place it inside the `models\u002Finisghtface` directory.\n\nif you know of other models please let me know and I will add them to the unified loader.\n\n## Generic suggestions\n\nThere are many workflows included in the [examples](.\u002Fexamples\u002F) directory. Please check them before asking for support.\n\nUsually it's a good idea to lower the `weight` to at least `0.8` and increase the number steps. To increase adherece to the prompt you may try to change the **weight type** in the `IPAdapter Advanced` node.\n\n## Troubleshooting\n\nPlease check the [troubleshooting](https:\u002F\u002Fgithub.com\u002Fcubiq\u002FComfyUI_IPAdapter_plus\u002Fissues\u002F108) before posting a new issue. Also remember to check the previous closed issues.\n\n## Credits\n\n- [IPAdapter](https:\u002F\u002Fgithub.com\u002Ftencent-ailab\u002FIP-Adapter\u002F)\n- [InstantStyle](https:\u002F\u002Fgithub.com\u002FInstantStyle\u002FInstantStyle)\n- [B-Lora](https:\u002F\u002Fgithub.com\u002Fyardenfren1996\u002FB-LoRA\u002F)\n- [ComfyUI](https:\u002F\u002Fgithub.com\u002Fcomfyanonymous\u002FComfyUI)\n- [laksjdjf](https:\u002F\u002Fgithub.com\u002Flaksjdjf\u002F)\n","ComfyUI IPAdapter plus 是一个基于 ComfyUI 的 IPAdapter 模型实现，用于图像到图像的条件生成。该项目允许用户轻松地将参考图像的主题或风格转移到新的生成图像中，类似于单图LoRA的功能。项目采用Python语言开发，并且提供了多种示例工作流和视频教程来帮助用户理解和使用其全部功能。适合需要进行高质量图像转换、风格迁移或者创意图像生成的应用场景。尽管项目目前处于维护模式，但仍然欢迎关键更新和贡献。",2,"2026-06-11 03:36:03","high_star"]