Nodes/AAA Metadata System/Multi-LoRA Loader (Z-Image)
ComfyUI Node

Multi-LoRA Loader (Z-Image)

Z-Image LoRAs, four at a time, triggers included

By EricRollei·Created 10 months ago·Updated 9 months ago· 13
Multi-LoRA Loader (Z-Image)
  • model
  • clip
  • model
  • clip
  • prompt
  • prompt_with_triggers
  • loaded_loras_info
prompt
lora_1None
strength_11.00
clip_strength_11.00
lora_2None
strength_21.00
clip_strength_21.00
lora_3None
strength_31.00
clip_strength_31.00
lora_4None
strength_41.00
clip_strength_41.00
trigger_positionfront
trigger_separator,
query_civitaifalse

Z-Image is the 6B model that made near-Flux quality run on 12GB cards, and its LoRA ecosystem exploded fast - partly because Base released with real seed diversity, partly because it's small enough that fine-tunes are cheap. If you've stacked a few Z-Image LoRAs, you already know the drill: chained loader nodes, one per LoRA. This node does the chaining for the Z-Image case specifically.

Multi-LoRA Loader (Z-Image) is the Z-Image member of the AAA Metadata System pack's loader family, and it's the trimmed-down one: four slots instead of eight, named lora_1 through lora_4, each with its own strength_N and clip_strength_N. It takes model and clip (Z-Image routes text through a Qwen3 text encoder, but ComfyUI's Z-Image support still hands you a CLIP object to patch), applies the LoRAs, and returns the patched pair plus a trigger-word-aware prompt.

How it works

Same base engine as the other loaders, with a directory filter pinned to a Z_Image subfolder - the source scans Lora\Z_Image under your LoRA path. So yes, folder layout matters again: Z-Image LoRAs in the root directory won't show up. Sort them into a Z_Image folder and the dropdown fills itself with exactly your Z-Image collection.

The four slots take a name plus model strength and CLIP strength each. That CLIP strength matters on Z-Image: its text encoder is a real language model, and as with any LoRA that touches the text side, dialing clip strength down is often the difference between "style applied" and "prompt ignored."

The search toolbox is deliberately smaller than the general loaders - just the trigger machinery, because the node assumes the directory already did the filtering for you. query_civitai fetches trigger words from the Civitai API when the pack's local LoRA database has none; trigger_position (front/back) and trigger_separator control how the words get injected into prompt_with_triggers.

Outputs

  • model and clip - both patched, into your sampler and conditioning.
  • prompt_with_triggers - your prompt with trigger words injected.
  • prompt - your original prompt, passed through.
  • loaded_loras_info - a per-LoRA summary of what got loaded.

Installing it

cd ComfyUI/custom_nodes
git clone https://github.com/EricRollei/AAA_Metadata_System.git
cd AAA_Metadata_System
pip install -r requirements.txt

Restart ComfyUI, or install "AAA Metadata System" via ComfyUI Manager. No model downloads. License: CC BY-NC for non-commercial use; commercial use needs a paid license from the author.

Common issues

  • Empty dropdown - Z-Image LoRAs not in the Z_Image subfolder. Fix the layout; the loader rescans when you reconnect or restart.
  • No force_civitai_fetch field - right, this node doesn't have it. query_civitai is the only Civitai toggle here, so if you already fetched and the result is stale, clear the pack's civitai_cache.json or check back later.
  • Trigger words missing - DB entry absent and query_civitai off. Enable it (needs internet) or type the trigger manually.
  • Four slots isn't enough - that's the design; if you habitually stack more than four Z-Image LoRAs, the general Model-Only loader in the same pack is the escape hatch.

Z-Image LoRA culture is young and moving fast, so trigger words change as creators update cards - run query_civitai on a fresh download. Four slots, tidy folder, and this becomes the node you stop thinking about.

Categoryloaders/multi-lora/zimage

Inputs (18)

NameTypeDefaultDescription
modelMODEL
clipCLIP
promptSTRING
lora_1COMBONoneFirst LoRA to load
strength_1FLOAT1.00-10–10
clip_strength_1FLOAT1.00-10–10
lora_2COMBONoneSecond LoRA to load
strength_2FLOAT1.00-10–10
clip_strength_2FLOAT1.00-10–10
lora_3COMBONoneThird LoRA to load
strength_3FLOAT1.00-10–10
clip_strength_3FLOAT1.00-10–10
lora_4COMBONoneFourth LoRA to load
strength_4FLOAT1.00-10–10
clip_strength_4FLOAT1.00-10–10
trigger_positionCOMBOfront2 options: front, back
trigger_separatorSTRING,
query_civitaiBOOLEANfalseAutomatically query Civitai for trigger words

Outputs (5)

NameTypeDescription
modelMODEL
clipCLIP
promptSTRING
prompt_with_triggersSTRING
loaded_loras_infoSTRING