Instructions to use RuneXX/LTX-2.3-Workflows with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use RuneXX/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 --extra natten

# Download weights from this repo
# Substitute filenames from this repo's "Files and versions" if they differ
hf download RuneXX/LTX-2.3-Workflows \
    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.3-Workflows
# 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.3-Workflows/diffusion_models/<distilled-transformer>.safetensors \
    --text-encoder-path models/LTX-2.3-Workflows/text_encoders/gemma4-12b-with-proj-ltx-2.5-bf16.safetensors \
    --video-vae-path models/LTX-2.3-Workflows/vae/<video-vae>.safetensors \
    --audio-vae-path models/LTX-2.3-Workflows/vae/<audio-vae>.safetensors \
    --spatial-upsampler-path models/LTX-2.3-Workflows/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.3-Workflows/diffusion_models/<distilled-transformer>.safetensors \
    --text-encoder-path models/LTX-2.3-Workflows/text_encoders/gemma4-12b-with-proj-ltx-2.5-bf16.safetensors \
    --video-vae-path models/LTX-2.3-Workflows/vae/<video-vae>.safetensors \
    --audio-vae-path models/LTX-2.3-Workflows/vae/<audio-vae>.safetensors \
    --spatial-upsampler-path models/LTX-2.3-Workflows/latent_upscale_models/<spatial-upsampler>.safetensors \
    --temporal-upsampler-path models/LTX-2.3-Workflows/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

Notebooks
Google Colab
Kaggle

LTX-2.3-Workflows

Commit History

Update README.md

22daf5d
verified

RuneXX commited on Mar 6

Update README.md

bad5326
verified

RuneXX commited on Mar 6

Update README.md

2ab6a3d
verified

RuneXX commited on Mar 6

Update README.md

4a79e70
verified

RuneXX commited on Mar 6

Update README.md

1def1dd
verified

RuneXX commited on Mar 6

Update README.md

af98ada
verified

RuneXX commited on Mar 6

Update README.md

106f17f
verified

RuneXX commited on Mar 6

Update README.md

1fb6cf9
verified

RuneXX commited on Mar 6

Update LTX-2.3_-_I2V_T2V_Basic_GGUF.json

f195631
verified

RuneXX commited on Mar 6

Update README.md

09c0125
verified

RuneXX commited on Mar 6

Rename LTX-2.3_-_I2V_T2V_Basic_with_prompt_enhancer-EARLY-TEST.json to LTX-2.3_-_I2V_T2V_Basic_with_prompt_enhancer.json

c8fe7b8
verified

RuneXX commited on Mar 6

Update README.md

f16717b
verified

RuneXX commited on Mar 6

Update README.md

2b78bd7
verified

RuneXX commited on Mar 5

Update README.md

f686709
verified

RuneXX commited on Mar 5

Update README.md

139a178
verified

RuneXX commited on Mar 5

Update README.md

ca52f69
verified

RuneXX commited on Mar 5

Upload LTX-2.3_-_I2V_T2V_Basic_GGUF.json

a7fa366
verified

RuneXX commited on Mar 5

Update README.md

601b422
verified

RuneXX commited on Mar 5

Upload LTX-2.3_-_I2V_T2V_Basic.json

257a4d6
verified

RuneXX commited on Mar 5

Rename LTX-2.3_-_I2V_T2V_Basic_with_prompt_enhancer.json to LTX-2.3_-_I2V_T2V_Basic_with_prompt_enhancer-EARLY-TEST.json

c5a7df7
verified

RuneXX commited on Mar 5

Update README.md

0de18fc
verified

RuneXX commited on Mar 5

Update README.md

6554d96
verified

RuneXX commited on Mar 5

Update README.md

08a243c
verified

RuneXX commited on Mar 5

Update README.md

b24e832
verified

RuneXX commited on Mar 5

Update README.md

783862a
verified

RuneXX commited on Mar 5

Update README.md

c919ec1
verified

RuneXX commited on Mar 5

Update README.md

a7b63fa
verified

RuneXX commited on Mar 5

Delete .gitattributes

bb4fcc7
verified

RuneXX commited on Mar 5

Upload LTX-2.3_-_I2V_T2V_Basic_with_prompt_enhancer.json

44e582a
verified

RuneXX commited on Mar 5

initial commit

ce2036d
verified

RuneXX commited on Mar 5

Commit History

Update README.md 22daf5d verified

Update README.md bad5326 verified

Update README.md 2ab6a3d verified

Update README.md 4a79e70 verified

Update README.md 1def1dd verified

Update README.md af98ada verified

Update README.md 106f17f verified

Update README.md 1fb6cf9 verified

Update LTX-2.3_-_I2V_T2V_Basic_GGUF.json f195631 verified

Update README.md 09c0125 verified

Rename LTX-2.3_-_I2V_T2V_Basic_with_prompt_enhancer-EARLY-TEST.json to LTX-2.3_-_I2V_T2V_Basic_with_prompt_enhancer.json c8fe7b8 verified

Update README.md f16717b verified

Update README.md 2b78bd7 verified

Update README.md f686709 verified

Update README.md 139a178 verified

Update README.md ca52f69 verified

Upload LTX-2.3_-_I2V_T2V_Basic_GGUF.json a7fa366 verified

Update README.md 601b422 verified

Upload LTX-2.3_-_I2V_T2V_Basic.json 257a4d6 verified

Rename LTX-2.3_-_I2V_T2V_Basic_with_prompt_enhancer.json to LTX-2.3_-_I2V_T2V_Basic_with_prompt_enhancer-EARLY-TEST.json c5a7df7 verified

Update README.md 0de18fc verified

Update README.md 6554d96 verified

Update README.md 08a243c verified

Update README.md b24e832 verified

Update README.md 783862a verified

Update README.md c919ec1 verified

Update README.md a7b63fa verified

Delete .gitattributes bb4fcc7 verified

Upload LTX-2.3_-_I2V_T2V_Basic_with_prompt_enhancer.json 44e582a verified

initial commit ce2036d verified

Update README.md

22daf5d
verified

Update README.md

bad5326
verified

Update README.md

2ab6a3d
verified

Update README.md

4a79e70
verified

Update README.md

1def1dd
verified

Update README.md

af98ada
verified

Update README.md

106f17f
verified

Update README.md

1fb6cf9
verified

Update LTX-2.3_-_I2V_T2V_Basic_GGUF.json

f195631
verified

Update README.md

09c0125
verified

Rename LTX-2.3_-_I2V_T2V_Basic_with_prompt_enhancer-EARLY-TEST.json to LTX-2.3_-_I2V_T2V_Basic_with_prompt_enhancer.json

c8fe7b8
verified

Update README.md

f16717b
verified

Update README.md

2b78bd7
verified

Update README.md

f686709
verified

Update README.md

139a178
verified

Update README.md

ca52f69
verified

Upload LTX-2.3_-_I2V_T2V_Basic_GGUF.json

a7fa366
verified

Update README.md

601b422
verified

Upload LTX-2.3_-_I2V_T2V_Basic.json

257a4d6
verified

Rename LTX-2.3_-_I2V_T2V_Basic_with_prompt_enhancer.json to LTX-2.3_-_I2V_T2V_Basic_with_prompt_enhancer-EARLY-TEST.json

c5a7df7
verified

Update README.md

0de18fc
verified

Update README.md

6554d96
verified

Update README.md

08a243c
verified

Update README.md

b24e832
verified

Update README.md

783862a
verified

Update README.md

c919ec1
verified

Update README.md

a7b63fa
verified

Delete .gitattributes

bb4fcc7
verified

Upload LTX-2.3_-_I2V_T2V_Basic_with_prompt_enhancer.json

44e582a
verified

initial commit

ce2036d
verified