IPAdapterModelLoader(kolors) - Legacy

Every IP-Adapter workflow starts the same way: load the adapter weights. MZ_IPAdapterModelLoaderKolors is that loader for Kolors - one dropdown, one output, and the entire point is to produce the IPADAPTER object that MZ_IPAdapterAdvancedKolors and MZ_IPAdapterFaceID need. It's a legacy alias of cubiq's IPAdapterModelLoader from ComfyUI_IPAdapter_plus, re-exported under the MZ name; the display name says "Legacy" and the README now points at cubiq's own pack. Still, if you're reviving a 2024 Kolors workflow, this is the node it references.

How it works

The dropdown, ipadapter_file, lists everything in models/ipadapter/. You pick the Kolors adapter file and the node reads it into an IPADAPTER object - a bundle that also holds references to the clip vision model and (for FaceID) the insightface model so the apply node can reach them without extra wiring. The key discipline is picking the right weights for the job:

• ip_adapter_plus_general.bin (from Kwai-Kolors/Kolors-IP-Adapter-Plus) for style/image-prompt work → feeds MZ_IPAdapterAdvancedKolors.
• ipa-faceid-plus.bin (from Kwai-Kolors/Kolors-IP-Adapter-FaceID-Plus) for face consistency → feeds MZ_IPAdapterFaceID.

They're not interchangeable. Load the general weights into a FaceID apply node and you'll get an error or nonsense, because the FaceID node expects the face-identity projection structure. The loader also needs the corresponding clip vision model present (pytorch_model.bin from the IP-Adapter-Plus repo in models/clip_vision/), since the clip vision is part of the pipeline the IPADAPTER object wraps.

Inputs and outputs

• ipadapter_file - dropdown of files in models/ipadapter/.
• Output: IPADAPTER → the ipadapter input of MZ_IPAdapterAdvancedKolors or MZ_IPAdapterFaceID.

Install

Standard pack install: ComfyUI Manager search "ComfyUI-Kolors-MZ", or git clone https://github.com/MinusZoneAI/ComfyUI-Kolors-MZ into custom_nodes, restart. Then:

# Kwai-Kolors/Kolors-IP-Adapter-Plus
ip_adapter_plus_general.bin        -> models/ipadapter/
image_encoder/pytorch_model.bin    -> models/clip_vision/

Common issues

The empty dropdown is the telltale sign of a missing file - if models/ipadapter/ is empty, this loader has nothing to list. And remember the README's broader advice: Kolors IP-Adapter is now supported natively in cubiq's ComfyUI_IPAdapter_plus (updated to latest), so new workflows should use that pack's own loader rather than this legacy one. This node exists to keep old graphs working, not to be the start of a new one.