How to use from the
Use from the
LTX.io library
# 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 MLXBits/ltx-2.3-10eros-v1.2-dmd-mlx-q8 --local-dir models/ltx-2.3-10eros-v1.2-dmd-mlx-q8
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-10eros-v1.2-dmd-mlx-q8/<distilled-checkpoint>.safetensors \
    --spatial-upsampler-path models/ltx-2.3-10eros-v1.2-dmd-mlx-q8/<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-10eros-v1.2-dmd-mlx-q8/<checkpoint>.safetensors \
    --distilled-lora models/ltx-2.3-10eros-v1.2-dmd-mlx-q8/<distilled-lora>.safetensors 0.8 \
    --spatial-upsampler-path models/ltx-2.3-10eros-v1.2-dmd-mlx-q8/<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

Not-For-All-Audiences

This repository has been marked as containing sensitive content and may contain potentially harmful and sensitive information.

View model card