FlashML-org/FreeVideo

★ 3,049⑂ 388

Make videos on the computer you already own. FreeVideo runs MiniMax H3 in as little as 8 GB of VRAM and 16 GB of RAM, and adapts its acceleration path to your hardware.

About FlashML-org/FreeVideo

FlashML-org/FreeVideo is an open-source project on GitHub, mainly written in Python. Make videos on the computer you already own. FreeVideo runs MiniMax H3 in as little as 8 GB of VRAM and 16 GB of RAM It currently holds 3,049 stars and 388 forks with 589 open issues, and was last pushed on 2026-11-13 (repository created 2026-09-13).

Project Overview

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

GitHub Repository Details

Repository FlashML-org/FreeVideo · default branch main · size 62460 KB · watchers 13 · source: GitHub REST API and repository README

README

https://github.com/FlashML-org/FreeVideo/blob/HEAD/FreeVideo

| Windows | macOS | Linux | Community Results | Gallery | Discord | QQ Group | WeChat Group |

English · 中文

Make videos on the computer you already own. Powered by Video DeltaNet (VDN), FreeVideo runs MiniMax H3 in as little as 8 GB of VRAM and 16 GB of RAM, with acceleration adapted to your hardware.

https://github.com/user-attachments/assets/ecda7d0d-7fbe-4e0c-8c29-8f3315bafc15

More clips and the four quality levels side by side in the gallery →

News

About

FreeVideo is a local inference engine for MiniMax H3 on consumer GPUs, built on OpenVDN's 8-step VDN-H3 model with Video DeltaNet's hybrid attention.

It coordinates VRAM, system memory and disk, adapting weight placement, compute precision and attention kernels to the available hardware. FreeVideo runs as a ComfyUI plugin, with launchers for Windows, macOS and Linux. Its core features include:

Getting Started

Windows

1. Download FreeVideo.exe and run it. 2. Select an existing ComfyUI folder or install a new one. Existing model folders can be added for reuse; missing models are downloaded automatically. 3. Click Install & launch. ComfyUI opens in the browser with the FreeVideo workspace.

https://github.com/FlashML-org/FreeVideo/blob/HEAD/FreeVideo creative workspace

Security software: FreeVideo.exe is code-signed. If security software blocks FreeVideo.exe or quarantines files in the FreeVideo folder, check that the SHA-256 of FreeVideo.exe matches the value on the release page, then restore the files and add the FreeVideo folder to the software's exclusion list.

Offline installation: Download the packages from Quark and drag the ZIP files into the launcher without extracting them. A fully offline installation needs the four model packs (video model, text encoder, video & audio decoder, and sampling caches), plus the environment package for a new ComfyUI installation. After importing only the environment package, you can also choose Automatic download for the models (v0.3.12 or newer). The audio reference cache is optional and is used only when a reference includes audio.

macOS (Apple silicon preview)

1. Download FreeVideo-Mac-arm64.dmg, open it and drag FreeVideo.app into Applications. 2. Open FreeVideo, then select an existing ComfyUI folder or install a new one. Existing model folders can be added for reuse; the runtime environment and missing models are downloaded automatically. 3. Click Install & launch. ComfyUI opens in the browser with the FreeVideo workspace.

This preview has been tested on an M5 Mac with 24 GB of unified memory. See the Mac guide for generation times and memory.

The Mac preview isn't notarized by Apple yet, so macOS blocks it the first time you open it. Download it only from the Releases page, then check the file and approve it as described in the Mac guide. This approves FreeVideo only; your other security settings stay as they are.

Existing ComfyUI

Install FreeVideo as a custom node:

cd ComfyUI/custom_nodes
git clone https://github.com/FlashML-org/FreeVideo.git

Restart ComfyUI, open Workflow → Browse Templates → FreeVideo → FreeVideo-All-in-One, and complete the setup in FreeVideo Settings.

Linux

Desktop: Download FreeVideo-Linux-x86_64.AppImage, make it executable and open it, then follow the same steps as on Windows.

Terminal or server:

git clone https://github.com/FlashML-org/FreeVideo.git && cd FreeVideo
./setup.sh

Setup installs FreeVideo, ComfyUI and the models, then opens FreeVideo in the browser. Afterwards, type freevideo to open it again. On a server, connect from your own computer through SSH, or run freevideo server --listen 0.0.0.0 for an access link on your local network. See the Linux guide.

More details

Support

Report bugs in GitHub Issues, or ask questions on Discord, QQ or WeChat.

Citation

FreeVideo is based on VDN-H3. If you use FreeVideo in your research, please cite the Video DeltaNet paper:

@article{xi2026videodeltanet,
  title={Video DeltaNet: A Video-Native Hybrid Attention for Livestream Video Generation},
  author={Xi, Haocheng and Xie, Yiming and Zhao, Hexu and Zhang, Yiwen and Liu, Michael and Creavin, Thomas and Keutzer, Kurt and Li, Xiuyu and Lv, Zhaoyang and Xu, Chenfeng and Feng, Haiwen},
  journal={arXiv preprint arXiv:2609.20744},
  year={2026}
}

Team

Project Team

Bowen Xue · Shuo Yang · Haocheng Xi · Xiaoze Fan · Chenfeng Xu

Special Thanks

Special thanks to AIwood爱屋研究室 and T8star-Aix for testing the project and providing valuable feedback.

Listed in chronological order of participation.

Acknowledgment

We thank OpenVDN for Video DeltaNet / VDN-H3 and its open-source model weights, training code and inference implementation.

We thank Impossible Research for providing computation resources.

We also thank MiniMax H3 for the base model and the following projects: ComfyUI, Diffusers, SageAttention, the MiniMax H3 latent upscaler, the H3 text encoder for ComfyUI and Qt for Python.

License

The code is released under the Apache License 2.0. The model weights are licensed under the MiniMax H3 Community License, which includes territorial and acceptable-use restrictions.

GitHub Stars & Activity

3,049Stars
388Forks
589Open issues
PythonLanguage

GitHub Popularity

GitHub stars3,049
Forks388
Open issues589
Primary languagePython
LicenseApache-2.0
Stars gained today0
Created2026-09-13
Last pushed2026-11-13

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