ComfyUI Node
Hunyuan 3 Loader (NF4 Low VRAM+)
A ComfyUI node in HunyuanImage3 with 6 inputs and 1 output.
Hunyuan 3 Loader (NF4 Low VRAM+)
- unload_signal
- HUNYUAN_MODEL
◄model_name▾►
◄force_reloadfalse►
◄blocks_to_swap20►
◄reserve_memory_gb6.0►
◄gpu_memory_target_gb18.0►
CategoryHunyuanImage3
Inputs (6)
| Name | Type | Default | Description |
|---|---|---|---|
| model_name | COMBO | 1 options: HunyuanImage-3-NF4 | |
| force_reload | BOOLEAN | false | — |
| blocks_to_swap | INT | 200–32 | Number of transformer blocks to keep on CPU and swap to GPU during inference. 20 is a good default for 24GB GPUs (keeps ~12 blocks on GPU). Set 0 to disable block swap and use the legacy device_map loading path. |
| reserve_memory_gb | FLOAT | 6.02–20 | VRAM headroom reserved for inference activations (GB). Only used in legacy mode (blocks_to_swap=0). Leave ≥6GB so auto mode keeps inference breathing room. |
| gpu_memory_target_gb | FLOAT | 18.04–128 | Approximate GPU budget for NF4 weights (GB). Only used in legacy mode (blocks_to_swap=0). 18-20GB for 24GB GPUs, 26-28GB for 32GB GPUs. |
| unload_signalopt | * | — |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| HUNYUAN_MODEL | HUNYUAN_MODEL | — |