IPAdapter Plus reference: presets, vision encoders and FaceID dependencies

Purpose and scope

IPAdapterUnifiedLoader is an entry point for understanding resource pairing, not an independent generator. Use the running node's definition for its precise interface.

Source-supported context

The author's README describes unified/manual loaders and IPAdapter, CLIP Vision, FaceID and LoRA pairings. The complete package interface was not extracted class by class in the underlying research. Source 1 Source 2

Before you start

1. Ordinary image guidance needs a compatible base, vision encoder and adapter variant.

2. FaceID also needs its InsightFace environment and variant-specific LoRA where required.

3. Older examples and unified presets may use different classes rather than visually interchangeable controls.

Steps and checks

The sequence below is an editorial procedure based on the cited context, not a diagnosis already confirmed for your environment.

Step 1. Choose the reference purpose and base family, then find the author's matching minimal example.

Step 2. Prepare exact preset identities/names for unified loading or verify every file explicitly for manual loading.

Step 3. Trace image encoding and the model branch, comparing settings with fixed input.

Step 4. Send missing weights, vision-encoder, InsightFace and version errors to their specific guides instead of mixing all repairs in one paragraph.

Completion check

The preset can be traced to its resources, and the running server's actual inputs/outputs are known.

Limitations and cautions

The author marks the package maintenance-only. This is not a complete node encyclopedia and does not redistribute its reference media or weights.

Original sources

• ComfyUI IPAdapter Plus README — original record checked 2026-09-21.
• IPAdapterUnifiedLoader header error with additional startup failures — original record checked 2026-09-21.

Localization prepared: 2026-09-22. The source-check dates above were inherited from the existing article; this translation does not claim they were all rechecked today. No GPU run, minimum-memory measurement or runtime guarantee is supplied.

Related troubleshooting and guides

• IPAdapter model not found: unified presets and manual loaders use different rules
• CLIP Vision missing or incompatible: it is not the prompt's text encoder
• InsightFace installation or initialization fails: separate packages from FaceID assets