LibreAI / Video / HunyuanVideo
// video · Tencent-Hunyuan/HunyuanVideo

HunyuanVideo

HunyuanVideo: A Systematic Framework For Large Video Generation Model

★ 12.6k stars⑂ 1.3k forksCustom (check repo)updated 2026-06
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

HunyuanVideo is an open-source video project by Tencent-Hunyuan (Tencent-Hunyuan/HunyuanVideo on GitHub). It has 12,582 GitHub stars and 1,343 forks, is released under the Custom (check repo) license, and was last updated on GitHub on 29 June 2026.

GitHub stars
12,582
Forks
1,343
License
Custom (check repo)
Last updated on GitHub
29 June 2026
Category
Video
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Pick your task

    Generation, restoration, upscaling, face swap, or lip sync — each project here specializes, so start from the job to be done.

  2. Get the weights

    Download the model files the project needs; most READMEs link exact versions and where to place them.

  3. Set up the environment

    Python environments or Docker images are the norm — follow the install section for your GPU.

  4. Run and iterate

    Feed in prompts or source media, tune the settings, and re-run until the result lands.

// features

Why people love it

Open weights

Real model files you download and run — no API key, no per-second billing.

Local inference

Everything happens on your machine; footage never uploads anywhere.

Specialized pipelines

Each tool focuses on one job and does it well, instead of a shallow all-in-one.

Active research roots

Many of these ship alongside papers and keep absorbing new techniques.

Community workflows

Shared settings, presets, and integrations (especially around ComfyUI) multiply what one tool can do.

Commercial-friendly options

Several use permissive licenses — always confirm the model license for your use case.

Advertisement
// run it

Run it yourself

  1. Step 1 — Clone the repo

    Download the source and move into the project folder.

    git clone https://github.com/Tencent-Hunyuan/HunyuanVideo.git
    cd HunyuanVideo
  2. Step 2 — Create an environment

    Isolate dependencies so nothing clashes with your other projects.

    python -m venv .venv
    source .venv/bin/activate  # Windows: .venv\Scripts\activate
  3. Step 3 — Install and launch

    Install the requirements, then follow the README's launch command (it varies per project).

    pip install -r requirements.txt
// use cases

What you can build

Advertisement
// faq

Questions, answered

What GPU do I need?

It varies widely — upscalers run on modest cards, while full video diffusion wants serious VRAM. Check each project's docs.

Are the outputs commercially usable?

Often yes for the code, but model weights carry their own licenses — read both.

Who maintains HunyuanVideo?

It is an open-source project at Tencent-Hunyuan/HunyuanVideo with 1,343 forks. Check the repo's contributors and recent commits to see how active maintenance is.

How is quality vs commercial tools?

The gap keeps shrinking; for restoration and upscaling, open tools already match or beat paid ones.

Do these run on Mac?

Some do via MPS or CPU, but NVIDIA on Linux/Windows is the best-supported path.

Where do I get help?

GitHub issues and Discussions on each repo, plus Discord communities for the popular ones.

// keep exploring

Similar tools

Video

FaceFusion

Industry leading face manipulation platform

★ 30.1k starsCustom (check repo)
View guide →
Video

LivePortrait

Bring portraits to life!

★ 19.2k starsCustom (check repo)
View guide →
Video

Video2X

A machine learning-based video super resolution and frame interpolation framework. Est. Hack the Valley II, 2018

★ 21.9k starsAGPL-3.0
View guide →
Video

Helios

Real-time long video generation — a research model built for speed.

★ 2.2k starsApache-2.0
View guide →
Video

World-R1

Research model enforcing 3D constraints in text-to-video generation.

★ 427 starsMIT
View guide →
Video

MiniMax-MCP

Official MiniMax MCP server — TTS, image and video generation for agents.

★ 1.6k starsMIT
View guide →
// alternatives

Alternatives in Video

The most-starred other Video projects in the LibreAI catalogue — the realistic shortlist if HunyuanVideo is not the right fit.

Get HunyuanVideo

Free and open — grab the source, star the repo, and start creating.