/model-registry

name: model-registry
description: Curated download URLs and target directories, organized by family (Flux, WAN, LTX, Qwen, Z-Image, SD15/SDXL), for every model the comfyui-mcp skills reference, covering checkpoints, VAEs, text encoders, and LoRAs. Use when downloading models with download_model (action:"download" / action:"download_civitai"), when a workflow fails with a missing-model error, or when setting up a new machine.

Model Registry

One table per family: filename → source URL → target subdir under `<COMFYUI>/models/`. Use with `download_model({ action: "download", url, target_subfolder, filename })`. This registry grows with every release. If a model you need is missing, use `action:"search"` (HuggingFace) or `action:"download_civitai"` and consider contributing the row.

**Quant column (kitchen).** Filenames in this registry are mostly bf16 / fp8. NVFP4 and MXFP8 siblings, when a vendor publishes them, are the same stem with `nvfp4` / `mxfp8` in the name and belong in `diffusion_models/` too. `kitchen` action:"assess" only offers an NVFP4 swap when that sibling is **already listed locally** — it does not guess a URL from the filename. Blackwell (SM ≥ 10.0) is the GPU that can run NVFP4 / MXFP8 compute.

**Conventions**

• HF "resolve" URLs download directly: `https://huggingface.co/<repo>/resolve/main/<path>`
• 🔒 = gated repo, needs `HUGGINGFACE_TOKEN` (accept the license on the HF page first)
• CivitAI model-page URLs need `download_model` `action:"download_civitai"` (resolves version → file); raw `civitai.com/api/download/...` URLs work with `action:"download"` + `CIVITAI_API_TOKEN`
• Always verify the exact filename a workflow's loader expects. The `model-compatibility` skill covers which VAE/CLIP pairs with which architecture

Shared VAEs & text encoders (download these once)

| File | Source | Target | |---|---|---| | `ae.safetensors` (Flux/Z-Image VAE) | `huggingface.co/black-forest-labs/FLUX.1-schnell/resolve/main/ae.safetensors` (Apache, not gated) | `vae/` | | `vae-ft-mse-840000-ema-pruned.safetensors` (SD1.5 VAE) | `huggingface.co/stabilityai/sd-vae-ft-mse-original/resolve/main/vae-ft-mse-840000-ema-pruned.safetensors` | `vae/` | | `clip_l.safetensors` | `huggingface.co/comfyanonymous/flux_text_encoders/resolve/main/clip_l.safetensors` | `text_encoders/` | | `t5xxl_fp8_e4m3fn.safetensors` | `huggingface.co/comfyanonymous/flux_text_encoders/resolve/main/t5xxl_fp8_e4m3fn.safetensors` | `text_encoders/` | | `umt5_xxl_fp8_e4m3fn_scaled.safetensors` (WAN) | `huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged/resolve/main/split_files/text_encoders/umt5_xxl_fp8_e4m3fn_scaled.safetensors` | `text_encoders/` |

Flux (see `flux-txt2img` skill for workflows)

| File | Source | Target | |---|---|---| | `flux1-dev.safetensors` 🔒 | `huggingface.co/black-forest-labs/FLUX.1-dev` | `diffusion_models/` | | `flux1-schnell.safetensors` | `huggingface.co/black-forest-labs/FLUX.1-schnell/resolve/main/flux1-schnell.safetensors` | `diffusion_models/` | | `flux2-vae.safetensors` (Flux 2 Klein) | `huggingface.co/Comfy-Org/flux2-klein` — check repo for current path | `vae/` |

WAN 2.x video (see `wan-t2v-video` / `wan-flf-video` skills)

Comfy-Org repackages everything: `huggingface.co/Comfy-Org/Wan_2.2_ComfyUI_Repackaged` under `split_files/`.

| File | Path in repo | Target | |---|---|---| | `wan2.2_i2v_high_noise_14B_fp8_scaled.safetensors` | `split_files/diffusion_models/` | `diffusion_models/` | | `wan2.2_i2v_low_noise_14B_fp8_scaled.safetensors` | `split_files/diffusion_models/` | `diffusion_models/` | | `wan_2.1_vae.safetensors` | `split_files/vae/` | `vae/` | | `wan2.2_i2v_lightx2v_4steps_lora_v1_high_noise.safetensors` | `split_files/loras/` | `loras/` | | `wan2.2_i2v_lightx2v_4steps_lora_v1_low_noise.safetensors` | `split_files/loras/` | `loras/` | | Magical-morph I2V LoRAs (high/low) | `huggingface.co/NikolaSigmoid/wan2.2-i2v-loras-magical-morph` | `loras/` | | SkinMorph Redmond I2V 14B | `civitai.com/models/2210162` (use `action:"download_civitai"`) | `loras/` |

LTX-2 19B video (see `ltxv2-video` skill)

| File | Source | Target | |---|---|---| | `ltx-2-19b-distilled.safetensors` | `huggingface.co/Lightricks/LTX-2` — check repo for the bf16 distilled path | `checkpoints/` | | `gemma_3_12B_it_fp4_mixed.safetensors` | `huggingface.co/Comfy-Org` LTX repackage | `text_encoders/` | | `ltx-2-spatial-upscaler-x2-1.0.safetensors` | `huggingface.co/Lightricks/LTX-2` | `upscale_models/` | | Camera-control LoRAs (`dolly-left`, distilled-384) | `huggingface.co/Lightricks/LTX-2` LoRA dir | `loras/` |

Qwen-Image (see `qwen-txt2img` / `qwen-image-edit` skills)

| File | Source | Target | |---|---|---| | `qwen_image_fp8_e4m3fn.safetensors` | `huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/resolve/main/split_files/diffusion_models/qwen_image_fp8_e4m3fn.safetensors` | `diffusion_models/` | | `qwen_2.5_vl_7b_fp8_scaled.safetensors` | same repo, `split_files/text_encoders/` | `text_encoders/` | | `qwen_image_vae.safetensors` | same repo, `split_files/vae/` | `vae/` | | `qwen_image_edit_2511_bf16.safetensors` | `huggingface.co/Comfy-Org/Qwen-Image-Edit_ComfyUI` — check repo | `diffusion_models/` | | Qwen-Image 2512 Lightning LoRA | `huggingface.co/lightx2v/Qwen-Image-2512-Lightning` | `loras/` | | Qwen-Image-Edit 2511 Lightning LoRA | `huggingface.co/lightx2v/Qwen-Image-Edit-2511-Lightning` | `loras/` | | Qwen-Image 2512 Turbo LoRA | `huggingface.co/Wuli-art/Qwen-Image-2512-Turbo-LoRA` | `loras/` |

MiniMax H3 video (see `minimax-h3-video` skill)

Comfy-Org INT8 pack: `huggingface.co/Comfy-Org/MiniMax-H3`. Local weights are under the MiniMax H3 Community License (territory-restricted). Prefer the filenames the Comfy-Org templates already name.

| File | Source | Target | |---|---|---| | `minimax_h3_fl2va_pruned_int8_convrot.safetensors` | `huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/diffusion_models/minimax_h3_fl2va_pruned_int8_convrot.safetensors` | `diffusion_models/`