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] hf download SceneWorks/ltx-2.3-mlx --local-dir ltx-2.3-mlx
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- LM Studio
- Atomic Chat
|
Download README.md from SceneWorks/ltx-2.3-mlx: direct link, hf CLI and curl.
- Browser
- Download file 2.41 kB
-
https://huggingface.co/SceneWorks/ltx-2.3-mlx/resolve/main/README.md
- Command line
-
hf download hf://SceneWorks/ltx-2.3-mlx/README.md
-
curl -L -o README.md https://huggingface.co/SceneWorks/ltx-2.3-mlx/resolve/main/README.md
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. | |