AGENTS.md — ComfyUI-Auto_installer-Assets
Purpose
Pure assets repository (HuggingFace LFS + ModelScope mirror) for model files and installation binaries used by ComfyUI-Auto_installer. No code — only large binary files.
Ecosystem
This repo is consumed by:
- ComfyUI-Auto_installer — PowerShell download scripts reference these files by exact path
- ComfyUI-UmeAiRT-Toolkit — Automatic model downloader nodes pull from this repo
Any file rename or move here must be reflected in both projects' download logic.
Mirrors:
- HuggingFace: UmeAiRT/ComfyUI-Auto_installer
- ModelScope: UmeAiRT/ComfyUI-Auto-Installer-Assets
Folder Structure
| Folder | Contents | Notes |
|---|---|---|
models/diffusion_models/ |
Backbone models (GGUF + safetensors) | Official ComfyUI folder. Organized by family (FLUX/, WAN/, QWEN/, HiDream/, LTX-2/, LTXV/, Z-IMG/, MelBandRoFormer/) |
models/text_encoders/ |
Text encoders (T5, QWEN, GEMMA, LLAMA) | Official ComfyUI folder. NOT clip/ |
models/clip/ |
CLIP models only (clip_l, clip_g, ViT, longclip) | Different from text_encoders/. Do NOT put text encoders here |
models/clip_vision/ |
CLIP Vision encoders (clip_vision_h, sigclip) | Used by IP-Adapter / Redux |
models/checkpoints/ |
Full merged checkpoints | |
models/loras/ |
LoRA adapters | Organized by family (FLUX/, WAN2.1/, WAN2.2/, QWEN/, LTX-2/) |
models/vae/ |
VAE models (transverse, shared across families) | |
models/vae_approx/ |
Approximate VAE decoders (TAESD) | For fast preview |
models/controlnet/ |
ControlNet models | |
models/upscale_models/ |
Upscaler models (RealESRGAN, etc.) | |
models/style_models/ |
Style/Redux models | |
models/pulid/ |
PuLID face models | |
models/sams/ |
SAM segmentation models | |
models/ultralytics/ |
YOLO detection models (face, hand) | |
models/xlabs/ |
XLabs custom node models | ⚠️ Hardcoded path — do NOT move |
models/onnx/ |
ONNX upscalers for TensorRT | ⚠️ Hardcoded path — do NOT move |
models/tensorrt/ |
Pre-built TensorRT engines | ⚠️ Hardcoded path — do NOT move |
models/LLM/ |
Language models (Florence PromptGen) | Multi-file model directories |
bin/ |
Installation executables (Git, Python, CUDA, etc.) | |
whl/ |
Pre-compiled Python wheels | |
packages/ |
Zip archives (extensions, build tools, configs) |
Naming Conventions
GGUF files — Follow the official GGUF spec
Format: <BaseName>-<SizeLabel>-<FineTune>-<Encoding>.gguf
- CamelCase BaseName:
Flux1,Wan2.1,HiDream,LTXV,LTX-2,Qwen - Uppercase SizeLabel:
14B,1.3B,13B - Uppercase Encoding:
Q4_K_S,Q8_0,Q6_K - Hyphens between components
Examples: Flux1-Dev-Q4_K_S.gguf, Wan2.2-T2V-HighNoise-14B-Q8_0.gguf
Safetensors files — Community convention
- Lowercase with hyphens as separators
- Precision suffixes:
fp16,bf16,fp8_e4m3fn,fp8_scaled
Examples: wan2.1-t2v-14b-fp16.safetensors, qwen-image-edit-fp8_e4m3fn.safetensors
Quantization Coverage Target
Each diffusion model family should provide these versions when available upstream:
- Full precision:
bf16orfp16(safetensors) - Reduced precision:
fp8_e4m3fnorfp8_scaled(safetensors) - GGUF quantizations:
Q8_0,Q6_K,Q5_K_S,Q4_K_S,Q3_K_S