--- license: other license_name: ltx-2-community-license-agreement license_link: https://github.com/Lightricks/LTX-2/blob/v1.2.0/LICENSE.md base_model: - Lightricks/LTX-2.5 - google/gemma-4-12B-it library_name: mlx pipeline_tag: text-to-video tags: - mlx - candle - apple-silicon - cuda - ltx-2 - ltx-video - text-to-video - image-to-video - audio-video-generation --- # LTX-2.5 — turnkey SceneWorks MLX and Candle bundle This is the pinned, token-free model bundle used by [SceneWorks](https://github.com/SceneWorks/SceneWorks) for native LTX-2.5 generation. It contains the complete split LTX-2.5 pipeline at q4, q8, and bf16, both distilled and guided dev transformers, the shipped distilled rank-450 adapter, and the separately staged stock Gemma 4 prompt enhancer. A fresh SceneWorks install downloads these ready-to-run files; no in-app conversion or access to the gated source repositories is required. ## Repository layout | path | contents | |---|---| | `distilled/q4/`, `distilled/q8/`, `distilled/bf16/` | Complete distilled LTX-2.5 tier: transformer, self-contained Gemma 4 text encoder, connector, Conv VAE, DiffVAE, spatial and temporal upsamplers, duration head, audio VAE, vocoder, and split manifests. | | `dev/q4/`, `dev/q8/`, `dev/bf16/` | The same complete tier with the guided 30-step dev transformer. Distilled remains the SceneWorks default. | | `distilled_lora/` | Upstream LTX-2.5 distilled LoRA, with rank and alpha read from its safetensors metadata. | | `enhancer/` | Stock `google/gemma-4-12B-it` snapshot used only for opt-in T2V/I2V prompt enhancement. The tier-local self-contained text encoder remains the generation encoder. | | `licenses/` | LTX-2.x Community License Agreement (August 11, 2026), Apache License 2.0, the Gemma Prohibited Use Policy, and provenance notice. | Each tier is an indivisible pipeline contract: q4/q8/bf16 selects the matching representation for every quantizable segment. The tier's `split_model.json` records component identities and quantization; SceneWorks rejects incomplete or mismatched layouts. ## Provenance and modifications - LTX-2.5 components and the distilled LoRA derive from [Lightricks/LTX-2.5](https://huggingface.co/Lightricks/LTX-2.5) and the [LTX-2 v1.2.0 reference](https://github.com/Lightricks/LTX-2/tree/v1.2.0). SceneWorks converted and, where selected, quantized the components into the native split MLX/Candle layout; generative model behavior was not fine-tuned. - The dev transformer derives from the LTX-2.5 dev checkpoint and is packed through the same converter into q4/q8/bf16. - `enhancer/` mirrors the stock [google/gemma-4-12B-it](https://huggingface.co/google/gemma-4-12B-it) snapshot for offline-only prompt enhancement. - Hugging Face `extra_gated_*` repository metadata is intentionally absent. Removing the hosting-service click-through does not alter any license or use restriction included here. ## Licenses This repository contains components governed by separate terms: - LTX-2.5 weights, derivatives, and the distilled adapter: [LTX-2.x Community License Agreement](licenses/LTX-2-Community-License.txt), license date August 11, 2026. The agreement includes use restrictions and commercial licensing conditions and must travel with redistributed derivatives. - Gemma 4 text-encoder/enhancer weights: [Apache License 2.0](licenses/Apache-2.0.txt), with Google's [Gemma Prohibited Use Policy](licenses/Gemma-Prohibited-Use-Policy.txt) also reproduced here. - [NOTICE](licenses/NOTICE.txt) records the exact sourcing and the material difference from the Gemma 1–3 Terms of Use used by the older LTX-2.3 bundle. Downloading, using, modifying, or redistributing a component requires compliance with all terms applicable to that component.