ComfyUI-LTXVideo Nodes: Complete Installation and Usage Guide
Everything you need to know about the official ComfyUI-LTXVideo custom nodes — installation via ComfyUI Manager, key nodes like LTXVConditioning and LTXVScheduler, and workflow setup.
By ltx workflow
Editor's Note: ComfyUI-LTXVideo is the official custom node pack from Lightricks for running LTX-2.3 models inside ComfyUI. This guide covers installation via ComfyUI Manager, required models, available workflows, and advanced features like IC-LoRA control and HDR output — everything you need to get started with LTX 2.3 video generation.
ComfyUI-LTXVideo Nodes: Complete Installation and Usage Guide
A collection of powerful custom nodes that extend ComfyUI's capabilities for the LTX-2 video generation model.
LTX-2 is built into ComfyUI core, making it readily accessible to all ComfyUI users. This repository hosts additional nodes and workflows to help you get the most out of LTX-2's advanced features.
Prerequisites
Before you begin using an LTX-2 workflow in ComfyUI, make sure you have:
- ComfyUI installed
- CUDA-compatible GPU with 32GB+ VRAM
- 100GB+ free disk space for models and cache
Installation via ComfyUI Manager
The recommended way to install ComfyUI-LTXVideo is through ComfyUI Manager:
- Open ComfyUI
- Click the Manager button (or press Ctrl+M)
- Select Install Custom Nodes
- Search for "LTXVideo"
- Click Install
- Wait for installation to complete
- Restart ComfyUI
The nodes will appear in your node menu under the LTXVideo category. Required models will be downloaded on first use.
Required Models
Download the following models to the appropriate folders in your ComfyUI installation:
LTX-2.3 Model Checkpoint
Choose one and place it in COMFYUI_ROOT_FOLDER/models/checkpoints:
ltx-2.3-22b-dev.safetensorsltx-2.3-22b-distilled-1.1.safetensors
Spatial Upscaler
Required for two-stage pipeline workflows. Place in COMFYUI_ROOT_FOLDER/models/latent_upscale_models:
ltx-2.3-spatial-upscaler-x2-1.1.safetensorsltx-2.3-spatial-upscaler-x1.5-1.0.safetensors
Temporal Upscaler
Required for two-stage pipeline workflows. Place in COMFYUI_ROOT_FOLDER/models/latent_upscale_models:
ltx-2.3-temporal-upscaler-x2-1.0.safetensors
Distilled LoRA
Required for two-stage pipeline implementations. Place in COMFYUI_ROOT_FOLDER/models/loras:
ltx-2.3-22b-distilled-lora-384-1.1.safetensors
Gemma Text Encoder
Download all files to COMFYUI_ROOT_FOLDER/models/text_encoders/gemma-3-12b-it-qat-q4_0-unquantized:
- Gemma 3 (google/gemma-3-12b-it-qat-q4_0-unquantized on HuggingFace)
IC-LoRA Models (Optional)
Place in COMFYUI_ROOT_FOLDER/models/loras:
ltx-2.3-22b-ic-lora-union-control-ref0.5.safetensors— depth + edge controlltx-2.3-22b-ic-lora-motion-track-control-ref0.5.safetensors— motion trackingltx-2.3-22b-ic-lora-hdr-0.9.safetensors— HDR outputltx-2-19b-ic-lora-detailer.safetensors— video detailingltx-2-19b-ic-lora-pose-control.safetensors— human pose control
Camera Control LoRAs (Optional)
A set of camera movement LoRAs is available for dolly in/out/left/right, jib up/down, and static shots.
Example Workflows
After installation, example workflows are available at:
ComfyUI/custom_nodes/ComfyUI-LTXVideo/example_workflows/
LTX-2.3 Workflows
- Text/Image to Video (Single Stage) — Full and distilled model, single stage generation
- Text/Image to Video (Two Stage with Upsampling) — Distilled model with spatial/temporal upscaling
- IC-LoRA Union Control — Depth + human pose + edges control
- IC-LoRA Motion Tracking — I2V with motion tracking
- IC-LoRA HDR — High dynamic range video output
LTX-2.0 Workflows (Legacy)
- Text to video (full and distilled)
- Image to video (full and distilled)
- Video to video detailer
- IC-LoRA with depth, pose, and edge control
Union IC-LoRA
The Union IC-LoRA model combines depth and edge (canny) control conditions into a single unified LoRA.
Key features:
- Unified Control: One LoRA supports multiple control conditions (depth or edges)
- Downsampled Latent Processing: Operates on downsampled latent size, reducing memory usage and speeding up inference while maintaining quality
The union LoRA learns to parse multiple conditions and identify which control signals are present in the input, then processes them at reduced resolution for efficiency.
HDR IC-LoRA
The HDR IC-LoRA generates linear HDR video encoded in ARRI LogC3, enabling workflows that output high-dynamic-range content suitable for grading and EXR export.
Key features:
- Linear HDR output: Produces frames in LogC3-compressed space; the
LTXVHDRDecodePostprocessnode decodes these back to linear HDR values - SDR preview + raw HDR: Outputs both a Reinhard-tonemapped SDR preview and the raw linear HDR tensor
- EXR export: Set
OPENCV_IO_ENABLE_OPENEXR=1in your environment before starting ComfyUI to enable EXR sequence export
Low VRAM Tips
For systems with limited VRAM:
- Use the model loader nodes from
low_vram_loaders.py— these ensure correct execution order and perform model offloading to fit generation within 32GB VRAM - Use the
--reserve-vramComfyUI parameter:python -m main --reserve-vram 5(adjust the number in GB as needed)