Instructions to use SceneWorks/ltx-2.3-mlx with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use SceneWorks/ltx-2.3-mlx with MLX:
# Download the model from the Hub pip install huggingface_hub[hf_xet] huggingface-cli download --local-dir ltx-2.3-mlx SceneWorks/ltx-2.3-mlx
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- LM Studio
Upload README.md with huggingface_hub
Browse files
README.md
ADDED
|
@@ -0,0 +1,40 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: other
|
| 3 |
+
license_name: ltx-2-community-license
|
| 4 |
+
license_link: https://github.com/Lightricks/LTX-2/blob/main/LICENSE
|
| 5 |
+
base_model:
|
| 6 |
+
- Lightricks/LTX-2.3
|
| 7 |
+
- google/gemma-3-12b-it
|
| 8 |
+
library_name: mlx
|
| 9 |
+
pipeline_tag: text-to-video
|
| 10 |
+
tags:
|
| 11 |
+
- mlx
|
| 12 |
+
- apple-silicon
|
| 13 |
+
- ltx-2
|
| 14 |
+
- ltx-video
|
| 15 |
+
- text-to-video
|
| 16 |
+
- image-to-video
|
| 17 |
+
- video-generation
|
| 18 |
+
---
|
| 19 |
+
|
| 20 |
+
# LTX-2.3 — MLX (self-contained: video model + Gemma-3-12B text encoder)
|
| 21 |
+
|
| 22 |
+
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:
|
| 23 |
+
|
| 24 |
+
| dir | contents |
|
| 25 |
+
|---|---|
|
| 26 |
+
| `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`) |
|
| 27 |
+
| `q8/` | same components, MLX **Q8** (higher quality, larger) |
|
| 28 |
+
| `gemma/` | Gemma-3-12B-IT text encoder, MLX bf16 (5 shards + tokenizer + config) |
|
| 29 |
+
|
| 30 |
+
The engine reads the quant bits from each variant's `split_model.json`, and resolves the text encoder from `gemma/`.
|
| 31 |
+
|
| 32 |
+
## Provenance
|
| 33 |
+
- **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.
|
| 34 |
+
- **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)).
|
| 35 |
+
|
| 36 |
+
## Licenses — this bundle contains TWO models under TWO licenses
|
| 37 |
+
- **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.
|
| 38 |
+
- **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.
|
| 39 |
+
|
| 40 |
+
By downloading or using this repository you agree to **both** licenses.
|