hao-ai-lab/FastVideo

★ 4,780⑂ 518

A unified inference and post-training framework for accelerated video generation.

About hao-ai-lab/FastVideo

hao-ai-lab/FastVideo is an open-source project on GitHub, mainly written in Python. A unified inference and post-training framework for accelerated video generation. It currently holds 4,780 stars and 518 forks with 149 open issues, and was last pushed on 2026-11-03 (repository created 2024-10-24).

Project Overview

Git Homed tracks it on the Video Trending board and on the AI Video Trending list.

GitHub Repository Details

Repository hao-ai-lab/FastVideo · default branch main · size 439730 KB · watchers 38 · source: GitHub REST API and repository README

README

| Documentation | Cookbook | Quick Start | Weekly Dev Meeting | 🟣💬 Slack | 🟣💬 WeChat |

FastVideo is a unified post-training and real-time inference framework for accelerated video generation.

Recent news

More News

Key Features

FastVideo has the following features:

Getting Started

Install FastVideo with uv:

uv venv --python 3.12 --seed
source .venv/bin/activate

NVIDIA CUDA 12; use cu130 on CUDA 13

UV_TORCH_BACKEND=cu126 uv pip install fastvideo

Platform guides: NVIDIA GPUs, DGX Spark / GB10, Apple Silicon MLX, AMD / ROCm — or the full installation guide.

To have a coding agent do the install, give it the agent install prompt.

Sparse Distillation

Sparse distillation reaches >50× denoising speedup. See the distillation guide and the blog; the training recipes live under examples/distill/ with the FastVideo Synthetic datasets.

Dreamverse — Realtime Video Generation & Editing

Dreamverse is FastVideo's realtime video generation and editing platform — "vibe directing" a video as it streams. It lives in the monorepo under apps/dreamverse/ and ships its own backend (dreamverse-server) plus a web UI.

Try the live demo, read the blog, or run it yourself. Dreamverse deploys on a local GPU, a self-hosted B200 server over SSH, Docker, or serverless Modal — see the Dreamverse README.

Inference

Generating Your First Video

Here's a minimal example to generate a video using the default settings. Make sure VSA kernels are installed. Create a file called example.py with the following code:

import os
from fastvideo import VideoGenerator

def main(): os.environ["FASTVIDEO_ATTENTION_BACKEND"] = "VIDEO_SPARSE_ATTN"

# Create a video generator with a pre-trained model generator = VideoGenerator.from_pretrained( "FastVideo/FastWan2.1-T2V-1.3B-Diffusers", num_gpus=1, # Adjust based on your hardware )

# Define a prompt for your video prompt = "A curious raccoon peers through a vibrant field of yellow sunflowers, its eyes wide with interest."

# Generate the video video = generator.generate_video( prompt, output_path="my_videos/", # Controls where videos are saved save_video=True )

if __name__ == '__main__': main()

num_gpus=1 runs the worker in-process (weights load once, no extra Python process). On Colab/Kaggle-style machines with ~16GB host RAM, keep num_gpus=1; free-tier system memory does not grow with extra T4s, so num_gpus>1 is likely to OOM.

Run the script with:

python example.py

For a more detailed guide, please see our inference quick start.

More Guides

Awesome work using FastVideo or our research projects

🤝 Contributing

We welcome all contributions. Please check out our guide here. See details in development roadmap.

Acknowledgement

We learned the design and reused code from the following projects: Wan-Video, ThunderKittens, DMD2, diffusers, xDiT, vLLM, SGLang. We thank MBZUAI, Anyscale, and GMI Cloud for their support throughout this project.

Citation

If you find FastVideo useful, please consider citing our research work:

@article{zhang2025vsa,
  title={Vsa: Faster video diffusion with trainable sparse attention},
  author={Zhang, Peiyuan and Chen, Yongqi and Huang, Haofeng and Lin, Will and Liu, Zhengzhong and Stoica, Ion and Xing, Eric and Zhang, Hao},
  journal={arXiv preprint arXiv:2505.13389},
  year={2025}
}

@article{zhang2025fast, title={Fast video generation with sliding tile attention}, author={Zhang, Peiyuan and Chen, Yongqi and Su, Runlong and Ding, Hangliang and Stoica, Ion and Liu, Zhengzhong and Zhang, Hao}, journal={arXiv preprint arXiv:2502.04507}, year={2025} }

GitHub Stars & Activity

4,780Stars
518Forks
149Open issues
PythonLanguage

GitHub Popularity

GitHub stars4,780
Forks518
Open issues149
Primary languagePython
LicenseApache-2.0
Stars gained today0
Created2024-10-24
Last pushed2026-11-03

Trending History

Trending statusnot on today's boards

Related GitHub Projects

1

harry0703 / MoneyPrinterTurbo

Python★ 144,122⑂ 0
→
2

OpenMontageInc / OpenMontage

Python★ 81,161⑂ 0
→
3

ATH-MaaS / Pixelle-Video

Python★ 30,170⑂ 0
→
4

Wan-Video / Wan2.2

Python★ 18,718⑂ 0
→
5

Zulko / moviepy

Python★ 15,157⑂ 0
→
6

zai-org / CogVideo

Python★ 13,207⑂ 0
→
7

HKUDS / ViMax

Python★ 12,943⑂ 0
→
8

Tencent-Hunyuan / HunyuanVideo

Python★ 12,785⑂ 0
→

More Trending Repositories