Nodes/ComfyUI_IPAdapter_plus/IPAdapter Unified Loader Community
ComfyUI Node Runs on cloud

IPAdapter Unified Loader Community

One-click loading for the community-baked models

By cubiq·Created 3 years ago·Updated about a year ago· 6,086
IPAdapter Unified Loader Community
  • model
  • ipadapter
  • model
  • ipadapter
preset

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: Composition or Kolors. This is the only real choice.
  • ipadapter (optional) - lets you pass an already-loaded adapter through rather than having the node load one.
  • Outputs model and ipadapter - 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.safetensors or ip_plus_composition_sdxl.safetensors (Ostris's model).
  • Kolors: the Kolors IP-Adapter Plus .bin, which also wants the Kolors-specific clip-vit-large-patch14-336 image encoder in ComfyUI/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.

Categoryipadapter/loaders

Inputs (3)

NameTypeDefaultDescription
modelMODEL
presetCOMBO2 options: Composition, Kolors
ipadapteroptIPADAPTER

Outputs (2)

NameTypeDescription
modelMODEL
ipadapterIPADAPTER