Instructions to use Lightricks/LTX-2.3 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusers
How to use Lightricks/LTX-2.3 with Diffusers:
pip install -U diffusers transformers accelerate
import torch from diffusers import DiffusionPipeline from diffusers.utils import load_image, export_to_video # switch to "mps" for apple devices pipe = DiffusionPipeline.from_pretrained("Lightricks/LTX-2.3", dtype=torch.bfloat16, device_map="cuda") pipe.to("cuda") prompt = "A man with short gray hair plays a red electric guitar." image = load_image( "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/diffusers/guitar-man.png" ) output = pipe(image=image, prompt=prompt).frames[0] export_to_video(output, "output.mp4") - LTX.io
How to use Lightricks/LTX-2.3 with LTX.io:
# 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 Lightricks/LTX-2.3 --local-dir models/LTX-2.3 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/<distilled-checkpoint>.safetensors \ --spatial-upsampler-path models/LTX-2.3/<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/<checkpoint>.safetensors \ --distilled-lora models/LTX-2.3/<distilled-lora>.safetensors 0.8 \ --spatial-upsampler-path models/LTX-2.3/<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 - Notebooks
- Google Colab
- Kaggle
Community merge family built on LTX-2.3's audio branch + a working recipe for the x1.5 spatial upscaler's sequence-end corruption
Two things β a showcase and a workaround your users may want.
The showcase: LTX-2.3-distilled-1.1's audio branch is carrying an entire family of community merges β its voice quality scored 9-10/10 ("indistinguishable from a real actress") in blind line-by-line reviews, and we've paired it with JoyAI-Echo's multi-shot video branch in a per-tensor surgical merge, plus INT8 ConvRot exports using your official layer recipe (blocks 2-45 quantized, 0/1/46/47 bf16 β it transferred perfectly to the merged weights): https://huggingface.co/joeygambino/joyai-echo-ltx23-echoVid-ltxAud-surgical
The workaround, re: the confirmed x1.5-1.0 spatial upscaler issue (discussion #13, first/last-frame corruption on long sequences) β two practical rules that make it production-usable until a fixed x1.5 ships:
Reflect-pad the temporal axis ~8 latents per side before the upsampler and crop after β the boundary damage lands entirely in disposable mirrored latents. (Pad by mirroring [1..8] and [-9..-2], not edge-repeat.)
Keep spatial latent dims EVEN (canvas /32 must be even β 768-height, not 736): at x1.5 an odd latent count makes the rational resampler fabricate a half-latent band on one edge, which renders as a full-length smear.
With both rules applied the x1.5 upscaler runs clean on 300+ frame sequences. Happy to share the wrapper implementation if useful.
ooooh thank you!