ComfyUI Extension: ComfyUI_IPAdapter_plus

Authored by cubiq

Created

Updated

5,052 stars

ComfyUI reference implementation for IPAdapter models. The code is mostly taken from the original IPAdapter repository and laksjdjf's implementation, all credit goes to them. I just made the extension closer to ComfyUI philosophy.

Custom Nodes (44)

README

ComfyUI IPAdapter plus

ComfyUI reference implementation for IPAdapter models.

The 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.

[!IMPORTANT]
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.

Example workflows

The examples directory has many workflows that cover all IPAdapter functionalities.

IPAdapter Example workflow

Video Tutorials

<a href="https://youtu.be/_JzDcgKgghY" target="_blank"> <img src="https://img.youtube.com/vi/_JzDcgKgghY/hqdefault.jpg" alt="Watch the video" /> </a>

The following videos are about the previous version of IPAdapter, but they still contain valuable information.

:nerd_face: Basic usage video, :rocket: Advanced features video, :japanese_goblin: Attention Masking video, :movie_camera: Animation Features video

Installation

Download or git clone this repository inside ComfyUI/custom_nodes/ 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.

There'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.

Remember you can also use any custom location setting an ipadapter entry in the extra_model_paths.yaml file.

FaceID models require insightface, you need to install it in your ComfyUI environment. Check this issue for help. Remember that most FaceID models also need a LoRA.

For the Unified Loader to work the files need to be named exactly as shown in the list below.

Most 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.

All models can be found on huggingface.

Community's models

The community has baked some interesting IPAdapter models.

if you know of other models please let me know and I will add them to the unified loader.

Generic suggestions

There are many workflows included in the examples directory. Please check them before asking for support.

Usually 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.

Troubleshooting

Please check the troubleshooting before posting a new issue. Also remember to check the previous closed issues.

Credits