Exeyyy's picture
Add standard Exe AI header (README.md)
322643a verified
|
Raw History Blame Contribute Delete
3.32 kB
---
license: other
license_name: ltx-2.3
license_link: https://huggingface.co/Lightricks/LTX-2.3/blob/main/LICENSE
base_model: Lightricks/LTX-2.3
library_name: mlx
pipeline_tag: image-to-video
language:
- en
tags:
- mlx
- video
- image-to-video
- text-to-video
- ltx
- apple-silicon
- 8-bit
- quantized
---
<div align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://huggingface.co/exeterminal/Exe-Motion-Dynamic-V1-MLX/resolve/main/exe-chevron-dark.png">
<img src="https://huggingface.co/exeterminal/Exe-Motion-Dynamic-V1-MLX/resolve/main/exe-chevron-light.png" alt="Exe AI" width="72">
</picture>
<h1>Exe AI</h1>
<a href="https://exe-hq.net"><b>exe-hq.net</b></a>
</div>
---
<div align="center">
<img src="exe-motion-dynamic-hero.png" alt="Exe Motion Dynamic V1 — local image-to-video for Apple Silicon" width="100%">
</div>
# Exe Motion Dynamic V1
The video model of **Exe Motion**, built to run local on an Apple Silicon Mac.
It is **LTX-2.3 (22B distilled)** with one change that matters on a 64 GB
machine: the text encoder is quantized to **8-bit**, so the part that used to
be the memory spike of a run is now a quarter of its size.
**Website to the Main AI Agent Harness: https://exe-hq.net**
Everything runs on-device through [MLX](https://github.com/ml-explore/mlx) — no
cloud, no upload of your images or prompts.
## What was quantized
<div align="center">
<img src="exe-motion-dynamic-quant.png" alt="Bar chart: the text encoder shrinks from 46 GB in F32 to 12.5 GB in 8-bit, four times smaller" width="80%">
</div>
The Gemma text encoder shipped in **F32** and, at ~46 GB, was the biggest single
thing a run had to hold. It is loaded, used to read the prompt, then freed
before the transformer runs — so its size sets the peak. Quantizing it to 8-bit
takes it to **12.5 GB**, resident, without touching the transformer.
| Part | Before | After |
|---|---:|---:|
| Text encoder (Gemma) | 46 GB · F32 | **12.5 GB · 8-bit** |
| Transformer (22B distilled) | 35 GB | 35 GB · unchanged |
| Whole model on disk | ~89 GB | **~55 GB** |
The transformer is left at full precision on purpose: the runtime has no
quantized path for it, and a quantized copy would not load. The encoder is where
the win is, and it is the honest one.
## What it does
Image-to-video and text-to-video at up to 720p. Frame count drives the length
(24 fps); resolution is free in steps of 64. A distilled fast path keeps steps
low; there is no separate turbo weight to install.
## Recommended settings
- **Resolution**: 1280×704 is the default; drop it for longer clips or to save
memory.
- **Frames**: `8n+1` (81 ≈ 3.4 s, 121 ≈ 5 s). Longer needs more memory.
- **Apple Silicon**: long runs on a 64 GB machine still benefit from raising the
Metal working-set limit before starting:
`sudo sysctl iogpu.wired_limit_mb=59392`.
## Files
A whole, assembled build — nothing to convert or borrow:
```
transformer/ 22B distilled, bf16
text_encoder/ Gemma, 8-bit (this build's change)
text_projections/ connectors
vae/ audio_vae/ vocoder/ tokenizer/
```
## License
Weights inherit the license of the base model,
[Lightricks/LTX-2.3](https://huggingface.co/Lightricks/LTX-2.3). See the linked
LICENSE for terms.