ltx-2.3-mlx / README.md
SceneWorks's picture
Upload README.md with huggingface_hub
986e5b2 verified
|
Raw History Blame Contribute Delete
2.41 kB
---
license: other
license_name: ltx-2-community-license
license_link: https://github.com/Lightricks/LTX-2/blob/main/LICENSE
base_model:
- Lightricks/LTX-2.3
- google/gemma-3-12b-it
library_name: mlx
pipeline_tag: text-to-video
tags:
- mlx
- apple-silicon
- ltx-2
- ltx-video
- text-to-video
- image-to-video
- video-generation
---
# LTX-2.3 β€” MLX (self-contained: video model + Gemma-3-12B text encoder)
Native **MLX** (Apple Silicon) bundle for the [SceneWorks](https://huggingface.co/SceneWorks) app. Contains **everything the LTX-2.3 MLX engine loads at generation time**, in one repo:
| dir | contents |
|---|---|
| `q4/` | LTX-2.3 distilled video model, MLX **Q4** β€” `transformer` + `connector` + `upsampler` + `vae_decoder` + `vae_encoder` + `audio_vae` + `vocoder` + configs (`split_model.json` / `embedded_config.json` / `config.json`) |
| `q8/` | same components, MLX **Q8** (higher quality, larger) |
| `gemma/` | Gemma-3-12B-IT text encoder, MLX bf16 (5 shards + tokenizer + config) |
The engine reads the quant bits from each variant's `split_model.json`, and resolves the text encoder from `gemma/`.
## Provenance
- **LTX-2.3 video weights** (`q4/`, `q8/`): converted from [Lightricks/LTX-2.3](https://huggingface.co/Lightricks/LTX-2.3) (distilled checkpoint) to MLX (Q4 / Q8) via the SceneWorks native `mlx-gen-ltx` converter.
- **Gemma-3-12B text encoder** (`gemma/`): [mlx-community/gemma-3-12b-it-bf16](https://huggingface.co/mlx-community/gemma-3-12b-it-bf16) (MLX conversion of [google/gemma-3-12b-it](https://huggingface.co/google/gemma-3-12b-it)).
## Licenses β€” this bundle contains TWO models under TWO licenses
- **LTX-2.3** (`q4/`, `q8/`): **LTX-2 Community License Agreement** β€” https://github.com/Lightricks/LTX-2/blob/main/LICENSE . These are derivatives (MLX conversion / quantization) of LTX-2.3; redistribution is permitted under that license, which must travel with the weights, with the modification noted and the **Attachment A use-restrictions** applying. Entities with β‰₯ $10,000,000 annual revenue require a separate Lightricks commercial license.
- **Gemma** (`gemma/`): **Google Gemma Terms of Use** β€” https://ai.google.dev/gemma/terms . The Gemma Terms and the [Gemma Prohibited Use Policy](https://ai.google.dev/gemma/prohibited_use_policy) apply and must travel with these weights.
By downloading or using this repository you agree to **both** licenses.