metadata

title: Wan2GP
app_file: wgp.py
sdk: gradio
sdk_version: 5.23.0

WanGP

WanGP by DeepBeepMeep : The best Open Source Video Generative Models Accessible to the GPU Poor

WanGP supports the Wan (and derived models), Hunyuan Video and LTV Video models with:

Low VRAM requirements (as low as 6 GB of VRAM is sufficient for certain models)
Support for old GPUs (RTX 10XX, 20xx, ...)
Very Fast on the latest GPUs
Easy to use Full Web based interface
Auto download of the required model adapted to your specific architecture
Tools integrated to facilitate Video Generation : Mask Editor, Prompt Enhancer, Temporal and Spatial Generation
Loras Support to customize each model
Queuing system : make your shopping list of videos to generate and come back later

Discord Server to get Help from Other Users and show your Best Videos: https://discord.gg/g7efUW9jGV

Follow DeepBeepMeep on Twitter/X to get the Latest News: https://x.com/deepbeepmeep

🔥 Latest Updates

June 11 2025: WanGP v5.5

👋 Hunyuan Video Custom Audio: it is similar to Hunyuan Video Avatar except there isn't any lower limit on the number of frames and you can use your reference images in a different context than the image itself
Hunyuan Video Custom Edit: Hunyuan Video Controlnet, use it to do inpainting and replace a person in a video while still keeping his poses. Similar to Vace but less restricted than the Wan models in terms of content...

June 6 2025: WanGP v5.41

👋 Bonus release: Support for AccVideo Lora to speed up x2 Video generations in Wan models. Check the Loras documentation to get the usage instructions of AccVideo.
You will need to do a pip install -r requirements.txt

June 6 2025: WanGP v5.4

👋 World Exclusive : Hunyuan Video Avatar Support ! You won't need 80 GB of VRAM nor 32 GB oF VRAM, just 10 GB of VRAM will be sufficient to generate up to 15s of high quality speech / song driven Video at a high speed with no quality degradation. Support for TeaCache included.
Here is a link to the original repo where you will find some very interesting documentation and examples. https://github.com/Tencent-Hunyuan/HunyuanVideo-Avatar. Kudos to the Hunyuan Video Avatar team for the best model of its kind.
Also many thanks to Reevoy24 for his repackaging / completing the documentation

May 28 2025: WanGP v5.31

👋 Added Phantom 14B, a model that you can use to transfer objects / people in the video. My preference goes to Vace that remains the king of controlnets. VACE improvements: Better sliding window transitions, image mask support in Matanyone, new Extend Video feature, and enhanced background removal options.

May 26, 2025: WanGP v5.3

👋 Settings management revolution! Now you can:

Select any generated video and click Use Selected Video Settings to instantly reuse its configuration
Drag & drop videos to automatically extract their settings metadata
Export/import settings as JSON files for easy sharing and backup

May 20, 2025: WanGP v5.2

👋 CausVid support - Generate videos in just 4-12 steps with the new distilled Wan model! Also added experimental MoviiGen for 1080p generation (20GB+ VRAM required). Check the Loras documentation to get the usage instructions of CausVid.

May 18, 2025: WanGP v5.1

👋 LTX Video 13B Distilled - Generate high-quality videos in less than one minute!

May 17, 2025: WanGP v5.0

👋 One App to Rule Them All! Added Hunyuan Video and LTX Video support, plus Vace 14B and integrated prompt enhancer.

See full changelog: Changelog

🚀 Quick Start

One-click installation: Get started instantly with Pinokio App

Manual installation:

git clone https://github.com/deepbeepmeep/Wan2GP.git
cd Wan2GP
conda create -n wan2gp python=3.10.9
conda activate wan2gp
pip install torch==2.6.0 torchvision torchaudio --index-url https://download.pytorch.org/whl/test/cu124
pip install -r requirements.txt

Run the application:

python wgp.py  # Text-to-video (default)
python wgp.py --i2v  # Image-to-video

📦 Installation

For detailed installation instructions for different GPU generations:

Installation Guide - Complete setup instructions for RTX 10XX to RTX 50XX

🎯 Usage

Basic Usage

Getting Started Guide - First steps and basic usage
Models Overview - Available models and their capabilities

Advanced Features

Loras Guide - Using and managing Loras for customization
VACE ControlNet - Advanced video control and manipulation
Command Line Reference - All available command line options

📚 Documentation

Changelog - Latest updates and version history
Troubleshooting - Common issues and solutions

🔗 Related Projects

Other Models for the GPU Poor

HuanyuanVideoGP - One of the best open source Text to Video generators
Hunyuan3D-2GP - Image to 3D and text to 3D tool
FluxFillGP - Inpainting/outpainting tools based on Flux
Cosmos1GP - Text to world generator and image/video to world
OminiControlGP - Flux-derived application for object transfer
YuE GP - Song generator with instruments and singer's voice

Made with ❤️ by DeepBeepMeep