LTX-2 How to use zheann/LTX-2.3-Workflows with LTX-2:
# Install the LTX-2 pipelines
git clone https://github.com/Lightricks/LTX-2.git
cd LTX-2
uv sync --frozen
# Download the weights from this repo, plus the Gemma text encoder
hf download zheann/LTX-2.3-Workflows --local-dir models/LTX-2.3-Workflows
hf download google/gemma-3-12b-it-qat-q4_0-unquantized --local-dir models/gemma-3-12b
# Fast pipeline (distilled model, no distilled LoRA needed)
uv run python -m ltx_pipelines.distilled \
--distilled-checkpoint-path models/LTX-2.3-Workflows/<distilled-checkpoint>.safetensors \
--spatial-upsampler-path models/LTX-2.3-Workflows/<spatial-upsampler>.safetensors \
--gemma-root models/gemma-3-12b \
--prompt "A beautiful sunset over the ocean" \
--output-path output.mp4
# For image-to-video, add: --image path/to/image.jpg 0 0.8 # HQ pipeline (two-stage, higher quality)
uv run python -m ltx_pipelines.ti2vid_two_stages_hq \
--checkpoint-path models/LTX-2.3-Workflows/<checkpoint>.safetensors \
--distilled-lora models/LTX-2.3-Workflows/<distilled-lora>.safetensors 0.8 \
--spatial-upsampler-path models/LTX-2.3-Workflows/<spatial-upsampler>.safetensors \
--gemma-root models/gemma-3-12b \
--prompt "A beautiful sunset over the ocean" \
--output-path output.mp4
# For image-to-video, add: --image path/to/image.jpg 0 0.8 
