IPAdapter Unified Loader Community V2

The main Unified Loader in this pack covers the official Tencent IP-Adapter lineup. This sibling exists for the models Tencent didn't ship: the community-trained ones. It's a stripped-down version of the same loader with just two presets - Composition and Kolors - and it's the node to reach for when you want IP-Adapter's composition abilities or when your base model is a Kolors checkpoint.

Composition selects the plus_composition adapter (SD 1.5 or SDXL depending on your base). This is the variant trained specifically to carry the layout of the reference - where things sit, the arrangement of the scene - rather than its style or identity. It pairs naturally with the IPAdapterPreciseCompositionV2 apply node, which exists to give you a composition_boost knob on top of that signal. If you've ever had regular IP-Adapter drag the color palette along when all you wanted was the arrangement, this preset is the fix.

Kolors is the outlier. Kolors is a completely different base model (by Kwai-Kolors, Chinese-language-first) and it needs its own IP-Adapter implementation, the ip_adapter_plus_general / kolors.ip.adapter.plus weights plus a CLIP-Large-14-336 vision encoder. The loader handles all of that naming, but only works when your model input is actually a Kolors checkpoint - feed it an SDXL model and it raises "Only supported for Kolors model." It's a niche preset for a niche model, included because the pack inherits the full preset surface from cubiq's original.

Outputs are the standard pair: model and ipadapter. Feed ipadapter into any apply node; for Composition presets the Precise Composition or Advanced nodes are the ones that actually use the composition signal well.

What "community" means here

These weights aren't on the official h94 HuggingFace org. They're third-party trained adapters that circulate through CivitAI and mirror repos, which means two things: they're not Apache-2.0 guaranteed like the Tencent base/plus weights, and their provenance varies, so check the model card before you build something commercial on them. The KB's IP-Adapter panel keeps the official Tencent line and the community line separate for exactly this reason.

Install

Part of chflame163/ComfyUI_IPAdapter_plus_V2, the V2 fork of cubiq's pack. Via ComfyUI Manager (search ComfyUI_IPAdapter_plus_V2) or:

cd ComfyUI/custom_nodes
git clone https://github.com/chflame163/ComfyUI_IPAdapter_plus_V2

Restart. No pip requirements - the optional insightface dependency only matters for FaceID loaders, not this one.

Gotchas

The Composition adapter is picky about exact filenames (plus.composition.sdxl.safetensors), so a renamed download will produce "IPAdapter model not found." And don't reach for the Kolors preset unless you actually have a Kolors checkpoint loaded - the error message is the pack's way of keeping you honest. For the common case - an SDXL anime or photoreal model where you want composition control - Composition plus IPAdapterPreciseCompositionV2 is a genuinely useful combo that a lot of people never discover.