IPAdapter Unified Loader Community
One-click loading for the community-baked models
- model
- ipadapter
- model
- ipadapter
The regular Unified Loader handles the official Tencent IP-Adapter models. This one handles the community-baked models that aren't part of the official lineup - the ones other people trained and released. Right now that's two presets: Composition and Kolors. Pick a preset, and the node loads the matching adapter and wires it to your model, so you don't have to hunt down the right file-and-encoder combination yourself. It outputs both a model and an ipadapter, ready to drop into any apply node.
Why these two exist as community entries: the Composition model is Ostris's ip_plus_composition adapter, which conditions purely on a reference's composition - the arrangement - while ignoring its style and content. It's a genuinely different tool from the style-focused official adapters, and it's the easy way to say "lay it out like this, but I'll handle the look." Kolors is the IP-Adapter trained for Kwai's Kolors model, which uses a different image encoder than the SD/SDXL adapters, so it needs its own loader path.
How it works
It's a loader, so it sits at the front of your IPAdapter chain, not in the middle. It takes your model, looks up the files for the preset you chose, loads the adapter (and the correct image encoder for it), and returns the model plus a loaded ipadapter. From there you feed both into an apply node. The convenience is that it knows which encoder each community model needs - which is exactly the thing people get wrong when wiring adapters by hand.
The inputs and outputs
model- your base model (SDXL for Composition; the Kolors model for the Kolors preset).preset- the dropdown:CompositionorKolors. This is the only real choice.ipadapter(optional) - lets you pass an already-loaded adapter through rather than having the node load one.- Outputs
modelandipadapter- both wire straight into an IPAdapter apply node.
Installing the pack
ComfyUI Manager: search ComfyUI IPAdapter plus, install, restart. Or cd ComfyUI/custom_nodes && git clone https://github.com/cubiq/ComfyUI_IPAdapter_plus, then restart, keeping ComfyUI current. The community models are downloads you place yourself in ComfyUI/models/ipadapter:
- Composition:
ip_plus_composition_sd15.safetensorsorip_plus_composition_sdxl.safetensors(Ostris's model). - Kolors: the Kolors IP-Adapter Plus
.bin, which also wants the Kolors-specificclip-vit-large-patch14-336image encoder inComfyUI/models/clip_vision.
Name them as the README lists or the loader won't find them.
Where people get burned
The number-one failure is "model not found" - the loader can't see a file because it's in the wrong folder or misnamed. The Unified Loaders match by exact filename, so a rename or a stray subfolder is all it takes. Download the precise file the README names, drop it in ComfyUI/models/ipadapter, and it'll appear.
The Kolors-specific gotcha: it needs its own image encoder (that 336 CLIP), and if you're using the Kolors FaceID line, that variant is trained on InsightFace's antelopev2 model, which you have to download manually into the insightface directory - it won't auto-fetch. Miss that and Kolors FaceID errors out. And the general reminder: this pack is SD 1.5 / SDXL era (plus Kolors), maintenance-only, with nothing for Flux - the community presets here are the extent of the "extra" models it knows about.
Inputs (3)
| Name | Type | Default | Description |
|---|---|---|---|
| model | MODEL | — | |
| preset | COMBO | 2 options: Composition, Kolors | |
| ipadapteropt | IPADAPTER | — |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| model | MODEL | — |
| ipadapter | IPADAPTER | — |