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

Aug 28

15:14
Rename Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-LTX-Ingredients-OmniNTF_Experimental.json to Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora-combo_Experimental.json

RuneXX

Verified signature
0101d71
15:13
Upload LTX-2.3_-_I2V_reference-sheet_IC-Ingredients.json

RuneXX

Verified signature
bb401d7

Aug 21

10:58
Update README.md

RuneXX

Verified signature
5abf401
10:58
Update README.md

RuneXX

Verified signature
ee9b9d2
10:56
Update README.md

RuneXX

Verified signature
9e423fd
10:53
Update README.md

RuneXX

Verified signature
7dddd45

Aug 2

14:59
Update README.md

RuneXX

Verified signature
2b38e08

Jul 31

14:04
Upload Krea-2_-_Character-Sheet_from_prompt_4panel-lora.json

RuneXX

Verified signature
fdd0d4e
13:35
Rename Multi-ref-character-sheet/Helper-wf/Krea-2_-_Character-Sheet_from_ref_image.json to Multi-ref-character-sheet/Helper-wf/Krea-2_-_Character-Sheet_from_ref_image_4panel-lora.json

RuneXX

Verified signature
a08761e
13:29
Upload Krea-2_-_Character-Sheet_from_ref_image.json

RuneXX

Verified signature
aa2a6da

Jul 30

18:21
Update Video-2-Video/LTX-2.3_-_V2V_general_purpose_for_IC-Lora.json

RuneXX

Verified signature
821d823
18:02
Upload LTX-2.3_-_V2V_general_purpose_for_IC-Lora.json

RuneXX

Verified signature
376bb8d

Jul 29

22:09
Update Multi-ref-character-sheet/LTX-2.3_-_T2V_R2V_character-sheet_Best-Face-ID-Lora.json

RuneXX

Verified signature
79abd7d

Jul 21

20:08
Upload LTX-2.3_-_V2V_Foley_Add_Sound_To_Any_Video_Foley-Lora.json

RuneXX

Verified signature
343b44b
20:07
Rename Video-2-Video/LTX-2.3_-_V2V_Foley_Add_Sound_To_Any_Video.json to Video-2-Video/LTX-2.3_-_V2V_Foley_Add_Sound_To_Any_Video_old_version.json

RuneXX

Verified signature
f50ee9d
16:12
Update Video-2-Video/LTX-2.3_-_V2V_mass_remove_people_Clean-Plate-Lora.json

RuneXX

Verified signature
baeda60
14:05
Upload LTX-2.3_-_V2V_Upscale-Any-Video-Pixel-Spatial-Lora.json

RuneXX

Verified signature
9060223
00:21
Upload LTX-2.3_-_V2V_mass_remove_people_Clean-Plate-Lora.json

RuneXX

Verified signature
fed4f69

Jul 19

13:50
Upload LTX-2.3_-_T2V_R2V_face-ref-audio-ref_Best-Face-ID-Lora-ID-Lora_audio.json

RuneXX

Verified signature
d25bbca
13:30
Upload LTX-2.3_-_T2V_R2V_face-ref-custom-audio_Best-Face-ID-Lora.json

RuneXX

Verified signature
f016756
12:46
Upload LTX-2.3_-_T2V_R2V_face-ref-image_Best-Face-ID-Lora.json

RuneXX

Verified signature
fadeb25
12:04
Rename Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V1-lora_older_version.json to Multi-ref-character-sheet/Older-Version/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V1-lora_older_version.json

RuneXX

Verified signature
ab08896

Jul 15

18:58
Update Video-2-Video/LTX-2.3_-_V2V_Change_viewpoint_angle_CrossView-Lora.json

RuneXX

Verified signature
b03b009
18:53
Upload LTX-2.3_-_V2V_Change_viewpoint_angle_CrossView-Lora.json

RuneXX

Verified signature
00c68de

Jul 14

20:13
Update Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-LTX-Ingredients-OmniNTF_Experimental.json

RuneXX

Verified signature
ba75c97
20:11
Update Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora.json

RuneXX

Verified signature
6edf856
14:10
Update Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-LTX-Ingredients-OmniNTF_Experimental.json

RuneXX

Verified signature
8e9314a
14:10
Update Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora.json

RuneXX

Verified signature
891c6cc
12:06
Rename Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-lora.json to Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V1-lora_older_version.json

RuneXX

Verified signature
cc86bdc
12:06
Upload LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora.json

RuneXX

Verified signature
1831642
12:01
Rename Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora.json to Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-LTX-Ingredients-OmniNTF_Experimental.json

RuneXX

Verified signature
c394dad
09:01
Update Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora.json

RuneXX

Verified signature
ad51ffe
08:46
Update Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora.json

RuneXX

Verified signature
002d25b

Jul 13

21:45
Upload Ideogram_-_Reference_Sheet_for_Ingredients_lora.json

RuneXX

Verified signature
a5611a8
18:38
Update Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora.json

RuneXX

Verified signature
b8f03e4
18:23
Update Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora.json

RuneXX

Verified signature
f323d7b
18:18
Upload LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora.json

RuneXX

Verified signature
4c0b35d
12:44
Update Multi-ref-character-sheet/LTX-2.3_-_T2V_R2V_character-sheet_Best-Face-ID-Lora.json

RuneXX

Verified signature
b581d06
12:17
Upload LTX-2.3_-_T2V_R2V_character-sheet_Best-Face-ID-Lora.json

RuneXX

Verified signature
1981f69

Jul 12

15:10
Upload Flux_Klein_-_Character_Sheet_from_ref_image.json

RuneXX

Verified signature
56a7483
15:10
Update Multi-ref-character-sheet/Helper-wf/Qwen_Image_-_Character_Sheet_from_ref_image_ZIT_refiner.json

RuneXX

Verified signature
f9c4601
13:35
Rename Multi-ref-character-sheet/Qwen_Image_-_Character_Sheet_from_ref_image_ZIT_refiner.json to Multi-ref-character-sheet/Helper-wf/Qwen_Image_-_Character_Sheet_from_ref_image_ZIT_refiner.json

RuneXX

Verified signature
6de376a
13:35
Upload Qwen_Image_-_Character_Sheet_from_ref_image_ZIT_refiner.json

RuneXX

Verified signature
c298f61
13:31
Rename LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-lora.json to Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-lora.json

RuneXX

Verified signature
40dfe40

Jun 2

00:54
Update LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-lora.json

RuneXX

Verified signature
13983ac

Jun 1

23:48
Upload LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-lora.json

RuneXX

Verified signature
f5c6de9
00:15
Update Video-2-Video/Inpaint/LTX-2.3_-_V2V_inpainting_Inpaint-T2V-lora_Sam3-Masking.json

RuneXX

Verified signature
2150a3f
00:14
Update Video-2-Video/Inpaint/LTX-2.3_-_V2V_inpainting_Inpaint-T2V-lora_Sam2-Point-Masking.json

RuneXX

Verified signature
abddc4a

May 31

22:43
Rename Video-2-Video/LTX-2.3_-_V2V_shot-to-shot-transition_Systms-FLW-lora.json to Video-2-Video/Shot-to-Shot-Transition/LTX-2.3_-_V2V_shot-to-shot-transition_Systms-FLW-lora.json

RuneXX

Verified signature
b28594b
22:43
Rename Video-2-Video/LTX-2.3_-_V2V_shot-to-shot-transition_Re-Take_inpaint.json to Video-2-Video/Shot-to-Shot-Transition/LTX-2.3_-_V2V_shot-to-shot-transition_Re-Take_inpaint.json

RuneXX

Verified signature
e62c772

Commit History

Aug 28

Rename Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-LTX-Ingredients-OmniNTF_Experimental.json to Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora-combo_Experimental.json

Upload LTX-2.3_-_I2V_reference-sheet_IC-Ingredients.json

Aug 21

Update README.md

Update README.md

Update README.md

Update README.md

Aug 2

Update README.md

Jul 31

Upload Krea-2_-_Character-Sheet_from_prompt_4panel-lora.json

Rename Multi-ref-character-sheet/Helper-wf/Krea-2_-_Character-Sheet_from_ref_image.json to Multi-ref-character-sheet/Helper-wf/Krea-2_-_Character-Sheet_from_ref_image_4panel-lora.json

Upload Krea-2_-_Character-Sheet_from_ref_image.json

Jul 30

Update Video-2-Video/LTX-2.3_-_V2V_general_purpose_for_IC-Lora.json

Upload LTX-2.3_-_V2V_general_purpose_for_IC-Lora.json

Jul 29

Update Multi-ref-character-sheet/LTX-2.3_-_T2V_R2V_character-sheet_Best-Face-ID-Lora.json

Jul 21

Upload LTX-2.3_-_V2V_Foley_Add_Sound_To_Any_Video_Foley-Lora.json

Rename Video-2-Video/LTX-2.3_-_V2V_Foley_Add_Sound_To_Any_Video.json to Video-2-Video/LTX-2.3_-_V2V_Foley_Add_Sound_To_Any_Video_old_version.json

Update Video-2-Video/LTX-2.3_-_V2V_mass_remove_people_Clean-Plate-Lora.json

Upload LTX-2.3_-_V2V_Upscale-Any-Video-Pixel-Spatial-Lora.json

Upload LTX-2.3_-_V2V_mass_remove_people_Clean-Plate-Lora.json

Jul 19

Upload LTX-2.3_-_T2V_R2V_face-ref-audio-ref_Best-Face-ID-Lora-ID-Lora_audio.json

Upload LTX-2.3_-_T2V_R2V_face-ref-custom-audio_Best-Face-ID-Lora.json

Upload LTX-2.3_-_T2V_R2V_face-ref-image_Best-Face-ID-Lora.json

Rename Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V1-lora_older_version.json to Multi-ref-character-sheet/Older-Version/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V1-lora_older_version.json

Jul 15

Update Video-2-Video/LTX-2.3_-_V2V_Change_viewpoint_angle_CrossView-Lora.json

Upload LTX-2.3_-_V2V_Change_viewpoint_angle_CrossView-Lora.json

Jul 14

Update Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-LTX-Ingredients-OmniNTF_Experimental.json

Update Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora.json

Update Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-LTX-Ingredients-OmniNTF_Experimental.json

Update Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora.json

Rename Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-lora.json to Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V1-lora_older_version.json

Upload LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora.json

Rename Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora.json to Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-LTX-Ingredients-OmniNTF_Experimental.json

Update Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora.json

Update Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora.json

Jul 13

Upload Ideogram_-_Reference_Sheet_for_Ingredients_lora.json

Update Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora.json

Update Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora.json

Upload LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-V2-lora.json

Update Multi-ref-character-sheet/LTX-2.3_-_T2V_R2V_character-sheet_Best-Face-ID-Lora.json

Upload LTX-2.3_-_T2V_R2V_character-sheet_Best-Face-ID-Lora.json

Jul 12

Upload Flux_Klein_-_Character_Sheet_from_ref_image.json

Update Multi-ref-character-sheet/Helper-wf/Qwen_Image_-_Character_Sheet_from_ref_image_ZIT_refiner.json

Rename Multi-ref-character-sheet/Qwen_Image_-_Character_Sheet_from_ref_image_ZIT_refiner.json to Multi-ref-character-sheet/Helper-wf/Qwen_Image_-_Character_Sheet_from_ref_image_ZIT_refiner.json

Upload Qwen_Image_-_Character_Sheet_from_ref_image_ZIT_refiner.json

Rename LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-lora.json to Multi-ref-character-sheet/LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-lora.json

Jun 2

Update LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-lora.json

Jun 1

Upload LTX-2.3_-_I2V_multi-subject-reference_Licon-MSR-lora.json

Update Video-2-Video/Inpaint/LTX-2.3_-_V2V_inpainting_Inpaint-T2V-lora_Sam3-Masking.json

Update Video-2-Video/Inpaint/LTX-2.3_-_V2V_inpainting_Inpaint-T2V-lora_Sam2-Point-Masking.json

May 31

Rename Video-2-Video/LTX-2.3_-_V2V_shot-to-shot-transition_Systms-FLW-lora.json to Video-2-Video/Shot-to-Shot-Transition/LTX-2.3_-_V2V_shot-to-shot-transition_Systms-FLW-lora.json

Rename Video-2-Video/LTX-2.3_-_V2V_shot-to-shot-transition_Re-Take_inpaint.json to Video-2-Video/Shot-to-Shot-Transition/LTX-2.3_-_V2V_shot-to-shot-transition_Re-Take_inpaint.json