Instructions to use BennyDaBall/LTX-2.5-22b-distilled-nvfp4-comfy with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- LTX-2
How to use BennyDaBall/LTX-2.5-22b-distilled-nvfp4-comfy with LTX-2:
# Install the LTX-2 pipelines git clone https://github.com/Lightricks/LTX-2.git cd LTX-2 uv sync --extra natten
# Download weights from this repo # Substitute filenames from this repo's "Files and versions" if they differ hf download BennyDaBall/LTX-2.5-22b-distilled-nvfp4-comfy \ diffusion_models/<distilled-transformer>.safetensors \ text_encoders/gemma4-12b-with-proj-ltx-2.5-bf16.safetensors \ vae/<video-vae>.safetensors \ vae/<audio-vae>.safetensors \ latent_upscale_models/<spatial-upsampler>.safetensors \ latent_upscale_models/<temporal-upsampler>.safetensors \ --local-dir models/LTX-2.5-22b-distilled-nvfp4-comfy # DFR requires the detailing IC-LoRA (separate repo; strength is fixed at 0.5) hf download Lightricks/LTX-2.5-22b-IC-LoRA-Pixel-Spatial-Upscaler --local-dir models/LTX-2.5-22b-IC-LoRA-Pixel-Spatial-Upscaler# Distilled LTX-2.5 pipeline (fast) uv run python -m ltx_pipelines.distilled \ --transformer-path models/LTX-2.5-22b-distilled-nvfp4-comfy/diffusion_models/<distilled-transformer>.safetensors \ --text-encoder-path models/LTX-2.5-22b-distilled-nvfp4-comfy/text_encoders/gemma4-12b-with-proj-ltx-2.5-bf16.safetensors \ --video-vae-path models/LTX-2.5-22b-distilled-nvfp4-comfy/vae/<video-vae>.safetensors \ --audio-vae-path models/LTX-2.5-22b-distilled-nvfp4-comfy/vae/<audio-vae>.safetensors \ --spatial-upsampler-path models/LTX-2.5-22b-distilled-nvfp4-comfy/latent_upscale_models/<spatial-upsampler>.safetensors \ --num-frames 121 \ --prompt "A beautiful sunset over the ocean" \ --output-path output.mp4 # For image-to-video, add: --image path/to/image.jpg 0 0.8# DFR pipeline (higher detail fidelity; optional temporal 2x/4x) uv run python -m ltx_pipelines.dfr_pipeline \ --transformer-path models/LTX-2.5-22b-distilled-nvfp4-comfy/diffusion_models/<distilled-transformer>.safetensors \ --text-encoder-path models/LTX-2.5-22b-distilled-nvfp4-comfy/text_encoders/gemma4-12b-with-proj-ltx-2.5-bf16.safetensors \ --video-vae-path models/LTX-2.5-22b-distilled-nvfp4-comfy/vae/<video-vae>.safetensors \ --audio-vae-path models/LTX-2.5-22b-distilled-nvfp4-comfy/vae/<audio-vae>.safetensors \ --spatial-upsampler-path models/LTX-2.5-22b-distilled-nvfp4-comfy/latent_upscale_models/<spatial-upsampler>.safetensors \ --temporal-upsampler-path models/LTX-2.5-22b-distilled-nvfp4-comfy/latent_upscale_models/<temporal-upsampler>.safetensors \ --detailing-lora models/LTX-2.5-22b-IC-LoRA-Pixel-Spatial-Upscaler/ltx-2.5-22b-ic-lora-pixel-spatial-upscaler-x2-1.0.safetensors \ --spatial-upscalings 1 \ --temporal-upscalings 1 \ --height 1088 \ --width 1920 \ --num-frames 121 \ --prompt "A beautiful sunset over the ocean" \ --output-path output.mp4 # For 4K: --spatial-upscalings 2 --width 3840 --height 2176 # For image-to-video, add: --image path/to/image.jpg 0 0.8 - Diffusion Single File
How to use BennyDaBall/LTX-2.5-22b-distilled-nvfp4-comfy with Diffusion Single File:
# No code snippets available yet for this library. # To use this model, check the repository files and the library's documentation. # Want to help? PRs adding snippets are welcome at: # https://github.com/huggingface/huggingface.js
- Notebooks
- Google Colab
- Kaggle
LTX-2.5 22B Distilled β NVFP4, ComfyUI-ready
The full NVFP4 build of the LTX-2.5 22B distilled transformer, stamped so ComfyUI actually loads it. Smallest working 22B on the board β 18.7GB, ~2.8GB lighter than the official comfy-int8 β and the same-seed output holds up frame for frame.

Image-to-video with this checkpoint, 50fps β the sign text stays legible the whole clip.
Same seed, same prompt, both quants:
| Official comfy-int8-convrot (21.5GB) | NVFP4 β this repo (18.7GB) |
![]() |
![]() |
![]() |
![]() |
Top row: text-to-video. Bottom row: image-to-video from a single keyframe β same start image, same seed, both quants. Native synced audio on all four (yes, the disco clips come with their own disco track).
The problem
Lightricks ships an NVFP4 export of the 2.5 distilled DiT, but it's a raw TensorRT-ModelOpt export. Load it through ComfyUI's UNETLoader and you get:
mat1 and mat2 shapes cannot be multiplied (6820x4096 and 2048x4096)
That 2048x4096 is a packed 4-bit weight being read as raw bytes β exactly half the width it should be. The funny part: the file's scale tensors (weight_scale, weight_scale_2, input_scale) already match ComfyUI's nvfp4 spec name-for-name. The only thing missing is the per-layer .comfy_quant marker tensor ComfyUI uses to detect quantized layers. Official "comfy-" packs have them; the NVFP4 export doesn't.
The fix
This repo is the official NVFP4 file with a {"format": "nvfp4"} marker stamped onto all 1,176 quantized layers. No requantization, no math β the weight bytes are untouched. It just tells ComfyUI what it's looking at.
| Base | Lightricks/LTX-2.5 ltx-2.5-22b-distilled-transformer-nvfp4 |
| Quant | NVFP4 (group 16, ModelOpt scales), 1,176 layers |
| Size | 18.7GB (vs 21.5GB comfy-int8-convrot) |
| Needs | ComfyUI β₯ v0.32.0, Blackwell GPU (RTX 50-series) for the FP4 kernels |
Usage
Drop it in ComfyUI/models/diffusion_models/ and pick it as unet_name in the stock LTX-2.5 Text to Video / Image to Video templates (ComfyUI ships them natively β no custom nodes). Text encoder, VAEs, and the latent upscaler come from the official repo as usual.
Lost? Grab ltx-2.5-nvfp4-t2v-example-workflow.json from this repo β the official T2V template with this model pre-selected. Load it, type a prompt, hit Queue.
Receipts
- Not pixel-identical (different quant noise), but close β same composition, same detail level, same motion beats. You'd have to flip between them to tell.
- 10s @ 1280Γ736 with synced audio in ~50s on an RTX 5090, including first model load.
- The 2.8GB of freed weight VRAM is real headroom against the long-duration offload cliff β the difference between finishing a clip and paging to death.
Credits
- Lightricks for LTX-2.5 and the source NVFP4 export.
- Conversion + testing: BennyDaBall_OG β follow me on X.
Disclaimer
Weights are governed by the LTX-2.x Community License (included). Use at your own risk; what you generate is on you.
- Downloads last month
- 5,794
Model tree for BennyDaBall/LTX-2.5-22b-distilled-nvfp4-comfy
Base model
Lightricks/LTX-2.5


