FreeVideo README

The project's README from github.com/FlashML-org/FreeVideo. As one markdown file: README.md.

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.
FreeVideo creative workspace

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.

FreeVideo (FlashML-org/FreeVideo)

ai-video
Searching Database…

2.1K ·GitHub
FreeVideo
What is this?FreeVideo is a local inference engine that lets you run the MiniMax H3 video generation model on your own consumer GPU instead of a cloud service, adapting its memory and compute strategy to your hardware.
Is this a standalone app or does it plug into something else?It runs as a ComfyUI plugin: a Windows launcher sets up ComfyUI and installs FreeVideo for you, while Linux users install it via the command line.
How do I get it running?On Windows, download FreeVideo.exe, pick or create a ComfyUI folder, and click Install & launch to open ComfyUI with the FreeVideo workspace. On an existing ComfyUI install, add FreeVideo as a custom node via Workflow to Browse Templates.
What hardware do I need to run it?FreeVideo is designed to run with as little as 8 GB of VRAM and 16 GB of system RAM, and it picks model packs tailored to your GPU generation (30/40 series or 50 series).
Is the model free to use for anything?The FreeVideo code itself is Apache-2.0, but the MiniMax H3 model weights come under a separate Community License with territorial and acceptable-use restrictions, so commercial or regional use may be limited.
Does it work on Linux too, not just Windows?Yes, Windows gets a one-click launcher, while Linux is supported through command-line installation and a prompt-file workflow; there is no mention of macOS support.
What kinds of inputs can I feed into a generation?You can combine text prompts with first and last frame images, and reference images, video, or audio, giving multiple ways to steer the generated clip.
Can I use community LoRAs with it?Yes, FreeVideo lets you load MiniMax H3 LoRAs directly into your ComfyUI workflow for customized styles.
What is Video DeltaNet (VDN)?VDN is the hybrid-attention architecture from OpenVDN that the underlying 8-step VDN-H3 model is built on, which is what lets MiniMax H3 run efficiently on consumer hardware.
Is there a fully offline install option?Yes, you can download the model and environment packages from Quark as ZIP files and drag them into the Windows launcher without extracting, avoiding any internet download during setup.
What are similar projects?LTX-Video, ComfyUI-Ref2VA-VSA, CogVideo, WanGP, awesome-minimax-h3-integration, hyperflow, ComfyUI-YCNodes-MiniMax-H3, CodeVideoModel
Which topics is it in?consumer-gpu, comfyui-nodes, minimax-h3, ai-video, image-to-video, inference-engine, comfyui, text-to-video, local-ai, diffusion-models, lora, gpu-acceleration
Creator
FlashML-org
Size
32.9 MB
Stars
2.1K
Updated
CommitOct 18Releasev0.4.14Oct 18
Age
1mo
Commits · 90 Days