Text-to-Video
Diffusers
Safetensors
English
MotifVideoPipeline
image-to-video
video-generation
diffusion-transformer
Instructions to use Motif-Technologies/Motif-Video-2B with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusers
How to use Motif-Technologies/Motif-Video-2B with Diffusers:
pip install -U diffusers transformers accelerate
import torch from diffusers import DiffusionPipeline # switch to "mps" for apple devices pipe = DiffusionPipeline.from_pretrained("Motif-Technologies/Motif-Video-2B", dtype=torch.bfloat16, device_map="cuda") prompt = "A vibrant blue jay perches gracefully on a slender branch, its feathers shimmering in the soft morning light. The bird's keen eyes scan the surroundings, capturing the essence of the tranquil forest. It flutters its wings briefly, showcasing the intricate patterns of blue, white, and black on its plumage. The background reveals a lush canopy of green leaves, with rays of sunlight filtering through, creating a dappled effect on the forest floor. The blue jay then tilts its head, emitting a melodious call that echoes through the serene woodland, adding a touch of magic to the peaceful scene." image = pipe(prompt).images[0] - Notebooks
- Google Colab
- Kaggle
Update README.md
Browse files
README.md
CHANGED
|
@@ -64,6 +64,7 @@ widget:
|
|
| 64 |
|
| 65 |
## 🔥 News
|
| 66 |
|
|
|
|
| 67 |
- **[2026-04-29]** **RTX 4090 benchmarks** added — SageAttention achieves ~3.16× speedup, all GGUF variants fit in 24 GB. See [GGUF + SageAttention](docs/gguf-sageattention.md#benchmark).
|
| 68 |
- **[2026-04-28]** **ComfyUI custom nodes** released: [ComfyUI-MotifVideo2B](https://github.com/MotifTechnologies/ComfyUI-MotifVideo2B). GGUF workflow support coming soon.
|
| 69 |
- **[2026-04-28]** **GGUF quantized weights** now available at [Motif-Video-2B-GGUF](https://huggingface.co/Motif-Technologies/Motif-Video-2B-GGUF) — up to 2.7 GB VRAM savings with no speed penalty. **SageAttention** support for ~2× faster inference. See [GGUF + SageAttention](#🧊-gguf--sageattention) below.
|
|
@@ -146,7 +147,7 @@ For the full derivation of why Shared Cross-Attention shares K/V but not Q, and
|
|
| 146 |
|
| 147 |
```bash
|
| 148 |
pip install "transformers>=5.5.4" torch accelerate ftfy einops sentencepiece regex Pillow imageio imageio-ffmpeg
|
| 149 |
-
pip install git+https://github.com/
|
| 150 |
```
|
| 151 |
|
| 152 |
### Text-to-Video (T2V)
|
|
@@ -206,23 +207,6 @@ output = pipe(
|
|
| 206 |
export_to_video(output.frames[0], "output.mp4", fps=24)
|
| 207 |
```
|
| 208 |
|
| 209 |
-
### CLI Inference
|
| 210 |
-
|
| 211 |
-
```bash
|
| 212 |
-
# Text-to-Video (default settings)
|
| 213 |
-
python inference.py \
|
| 214 |
-
--prompt "A woman standing in a sunlit field as..." \
|
| 215 |
-
--output t2v_output.mp4
|
| 216 |
-
|
| 217 |
-
# With SageAttention (~2x faster, requires sageattention package)
|
| 218 |
-
python inference.py \
|
| 219 |
-
--prompt "Three friends stride through a sun-bleached meadow..." \
|
| 220 |
-
--use-sage-attention \
|
| 221 |
-
--output t2v_output.mp4
|
| 222 |
-
```
|
| 223 |
-
|
| 224 |
-
See `inference.py --help` for all available options.
|
| 225 |
-
|
| 226 |
### Recommended Settings
|
| 227 |
|
| 228 |
| Parameter | Default | Notes |
|
|
|
|
| 64 |
|
| 65 |
## 🔥 News
|
| 66 |
|
| 67 |
+
- **[2026-05-15]** **Official Diffusers support** added — Motif-Video 2B is now officially supported in [Diffusers](https://huggingface.co/docs/diffusers/main/en/api/pipelines/motif_video), enabling native pipelines, schedulers, and ecosystem tooling integration.
|
| 68 |
- **[2026-04-29]** **RTX 4090 benchmarks** added — SageAttention achieves ~3.16× speedup, all GGUF variants fit in 24 GB. See [GGUF + SageAttention](docs/gguf-sageattention.md#benchmark).
|
| 69 |
- **[2026-04-28]** **ComfyUI custom nodes** released: [ComfyUI-MotifVideo2B](https://github.com/MotifTechnologies/ComfyUI-MotifVideo2B). GGUF workflow support coming soon.
|
| 70 |
- **[2026-04-28]** **GGUF quantized weights** now available at [Motif-Video-2B-GGUF](https://huggingface.co/Motif-Technologies/Motif-Video-2B-GGUF) — up to 2.7 GB VRAM savings with no speed penalty. **SageAttention** support for ~2× faster inference. See [GGUF + SageAttention](#🧊-gguf--sageattention) below.
|
|
|
|
| 147 |
|
| 148 |
```bash
|
| 149 |
pip install "transformers>=5.5.4" torch accelerate ftfy einops sentencepiece regex Pillow imageio imageio-ffmpeg
|
| 150 |
+
pip install git+https://github.com/huggingface/diffusers
|
| 151 |
```
|
| 152 |
|
| 153 |
### Text-to-Video (T2V)
|
|
|
|
| 207 |
export_to_video(output.frames[0], "output.mp4", fps=24)
|
| 208 |
```
|
| 209 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 210 |
### Recommended Settings
|
| 211 |
|
| 212 |
| Parameter | Default | Notes |
|