WanGP README

The project's README from github.com/deepbeepmeep/WanGP. As one markdown file: README.md.

WanGP


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

WanGP is a one-stop super app for the best open source generative models across video, image, audio, and text-to-speech.

Highlights

Modality Supported models
Video Wan 2.1/2.2 and derived models, MiniMax H3, LTX-2/2.3/2.5, Hunyuan Video 1/1.5, LongCat, Kandinsky, LTXV, MagiHuman
Image Krea 2, Qwen Image, Z-Image, Flux 1/2 (Klein, Chroma), SenseNova, Ideogram 4, HiDream
Audio / TTS Qwen3 TTS, MiniMax H3 Voice Clone, Ace Step 1/2/XL, Omnivoice, Index TTS2/2.5, KugelAudio, HeartMula, Chatterbox, Minimax Music, Stable Audio 3

Run More Models on More Hardware

Built-In Creation Tools

Discord Server to get Help from the WanGP Community and show your Best Gens: https://discord.gg/g7efUW9jGV

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

Official WanGP Web Site: https://wangp.ai/

[!IMPORTANT] WanGP is free to use locally. The official project will never ask you to pay a license fee, subscription, or donation to run WanGP on your own computer (see the license for terms).

Use only the official GitHub repository or wangp.ai / wan2gp.ai websites. WanGP is not affiliated to any other third-party service using the WanGP/Wan2GP names, unless explicitly stated here.

📋 Table of Contents

🔥 Latest Updates :

29th of September 2026: WanGP v13.141 — Community Release

Thanks to WanGP community contributing code, testing and feedback!

Community Contributions

Other Additions and Improvements

24th of September 2026: WanGP v13.1315 — It's Your Lucky Day^?!

WanGP supports VRAM Optimization, Pose/Depth/Edge Transfer, Inpainting, LanPaint, Outpainting, KV Cache Acceleration, and Enhanced Prompts from day one.

The base model works without an accelerator; optional LoRA profiles below offer faster 4- to 8-step generation.

Update v13.1313: YuE2 instrumental mode, YuE2 Hum to Song, AR LoRA support, and DFlash2 / DSpark acceleration
Update v13.1314: Ming Image 0.1 Design and Design-Layer, Qwen Image 2.1 Viggle Turbo and Pruna LoRA accelerators, and Remove Vocals audio postprocessing

16th of September 2026: WanGP v13.10 — It's Your Lucky Day!

WanGP Major Release

New Models

update 13.10: Prompt Enhancer Upgrades, LTX2.5 updates

6th of September 2026: WanGP v12.72 — Power Up, Polish, Pause

update WanGP v12.72*: H3 Outpainting, Viggle Animate

See full changelog: Changelog

🚀 Quick Start

One-click Bat/SH Script Auto-installer:

The 1-click automated scripts for both Windows (.bat) and Linux/macOS (.sh) make installation, environment management, and updates as seamless as possible. These scripts will not only install WanGP but also best acceleration kernels (Triton, Sage, Flash, GGuf, Lightx2v, Nunchaku) available for your config.

👉 Windows Users: Double-click the .bat files. Linux Users: Run the .sh files in your terminal.

1️⃣ Installation (scripts\install.bat | scripts/install.sh)

Choose Installation Type

Manual Install

If you selected Manual Install, you will be guided through:

  1. Choose your package manager
  2. Name your environment
  3. Select your Install Mode

2️⃣ Starting the App (scripts\run.bat | scripts/run.sh)

Once installed, use this script to launch the application. It runs WAN2GP using your active environment.

3️⃣ Updating & Upgrading (scripts\update.bat | scripts/update.sh)

Use this script to get the latest updates for WAN2GP and upgrade dependencies.

Triton recommendations follow both your GPU and selected PyTorch: 3.3.x with PyTorch 2.7, 3.6.x with PyTorch 2.10 on RTX 30XX or newer, 3.2.x on RTX 20XX, and 3.7.x with PyTorch 2.13 on AMD. Use Upgrade to correct an older Triton installation; Update alone does not change it.

4️⃣ Managing Environments (scripts\manage.bat | scripts/manage.sh)

Use this script to manage and switch between your sandboxed environments safely.


One-click Installers

Manual installation: (for RTX20xx - RTX50xx)

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

On Windows, install Triton in the same environment, using the command matching your GPU and PyTorch:

GPU PyTorch Command
RTX 30XX - RTX 50XX 2.10 (recommended) python -m pip install -U "triton-windows>=3.6,<3.7"
RTX 30XX - RTX 50XX 2.7 / 2.7.1 python -m pip install -U "triton-windows>=3.3,<3.4"
RTX 20XX 2.7 or 2.10 (legacy Triton compatibility exception) python -m pip install -U "triton-windows>=3.2,<3.3"

Triton 3.2 on RTX 30XX or newer can crash YuE2's optimized INT8 ConvRot kernels because it lacks triton.language.gather. Upgrade Triton as above and restart WanGP. RTX 20XX must stay on 3.2 and uses the existing standard INT8 path; compatibility with newer PyTorch is not guaranteed upstream. RTX 50XX users should use PyTorch 2.10 / Triton 3.6 for WanGP's optimized INT8 and NV FP4 support. Linux normally receives matching Triton through PyTorch. See the Triton Installation Guide for details and RTX 20XX limitations.

For optimized attention, install SageAttention 1.0.6 on RTX 20XX and SageAttention 2.2.0 on RTX 30XX or newer. SageAttention 2 requires an Ampere-or-newer GPU; GTX 10XX should use SDPA. See the Installation Guide for the platform-specific commands.

Manual installation: (for GTX 10xx)

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.7.1 torchvision==0.22.1 torchaudio==2.7.1 --index-url https://download.pytorch.org/whl/test/cu128
pip install -r requirements.txt

Run the application:

python wgp.py

If you are low on VRAM, there is a trick to increase the amount of VRAM available (between 1GB and 5GB of VRAM to be gained depending on the GPU): disable GPU Usage in your Web Browser.

Run scripts/start-chrome-no-gpu.bat or scripts/start-chrome-no-gpu.sh to launch Chrome without using your GPU.

First time using WanGP ? Just check the Guides tab, and you will find a selection of recommended models to use.

Update the application (stay in the current python / pytorch version):

If using Pinokio use Pinokio to update otherwise: Get in the directory where WanGP is installed and:

git pull
conda activate wan2gp
pip install -r requirements.txt

Upgrade from Python 3.10, Pytorch 2.7.1, Cuda 12.8 to Python 3.11, Pytorch 2.10, Cuda 13/13.1 (for non GTX10xx users)

I recommend renaming first the old conda environment to avoid bad surprises when installing a different config in this old environment.

conda rename -n wan2gp  old_wan2gp

Get in the directory where WanGP is installed and:

git pull
conda create -n wan2gp python=3.11.9
conda activate wan2gp
pip install torch==2.10.0 torchvision==0.25.0 torchaudio==2.10.0 --index-url https://download.pytorch.org/whl/cu130
pip install -r requirements.txt

Once you are done you will have to reinstall Sage Attention, Triton, Flash Attention. Check the Installation Guide -

if you get some error messages related to git, you may try the following (beware this will overwrite local changes made to the source code of WanGP):

git fetch origin && git reset --hard origin/main
conda activate wan2gp
pip install -r requirements.txt

When you have the confirmation it works well you can then delete the old conda env:

conda uninstall -n old_wan2gp --all  

Run headless (batch processing):

Process saved queues without launching the web UI:

# Process a saved queue
python wgp.py --process my_queue.zip

Create your queue in the web UI, save it with "Save Queue", then process it headless. See CLI Documentation for details.

🐳 Docker:

For Debian-based systems (Ubuntu, Debian, etc.):

./run-docker-cuda-deb.sh

This automated script will:

Docker environment includes:

Supported GPUs: RTX 40XX, RTX 30XX, RTX 20XX, GTX 16XX, GTX 10XX, Tesla V100, A100, H100, and more.

📦 Installation

Nvidia

For detailed installation instructions for different GPU generations:

AMD

For detailed installation instructions for different GPU generations:

🎯 Usage

Basic Usage

Advanced Features

📚 Documentation

📚 Video Guides

Other Models for the GPU Poor


Made with ❤️ by DeepBeepMeep

WanGP (deepbeepmeep/WanGP)

Searching Database…

10.6K ·GitHub
What is this?WanGP is a one-stop open source app for running top generative AI models for video, image, and audio/TTS generation, built specifically to work on modest consumer GPUs (the 'GPU Poor').
Is this a library or a ready-to-use app?It is a ready-to-use web application with a full Gradio browser UI, plus a headless/CLI mode and an API for integrating generation into your own apps.
How do I get it running?Follow the Quick Start / Installation section in the README to install dependencies and launch the web UI; model files are then fetched automatically based on your hardware.
What hardware do I need — do I need a top-tier Nvidia card?No, it's designed for low-VRAM setups: some models run with as little as 6GB VRAM, and it supports older Nvidia cards (GTX 10XX, RTX 20XX+) as well as AMD GPUs (RDNA 2/3/3.5/4).
Is WanGP actually free, or will it ask me to pay later?It's free to use locally and the official project states it will never charge a license fee, subscription, or donation to run it on your own machine; be wary of third-party sites using the WanGP name.
Which models can it actually run out of the box?It supports a huge range including Wan 2.1/2.2, MiniMax H3, LTX-2/2.3/2.5, Hunyuan Video, Krea 2, Qwen Image, Flux 1/2, plus audio/TTS models like Qwen3 TTS, Ace Step, and Chatterbox.
Does everything run locally, or does data go to a server?Generation runs locally on your own GPU; the only server-like feature is optional remote access to your own running instance from another device.
What is LoRA customization used for here?You can adapt any supported model with LoRAs for style or character control, and reuse LoRAs you already have stored from other apps.
Can I batch-process jobs without using the UI?Yes, headless mode lets you launch batches of image, video, or audio generations directly from the command line, and a generation queue lets you line up jobs to run while you're away.
What built-in editing tools come with it?It includes a mask editor, background remover, pose/depth/flow extractors, speaker diarization, upsampling (RIFE, FlashVSR, Lanczos), and audio tools like soundtrack remuxing and voice replacement via SeedVC.
What is Deepy?Deepy is a low-VRAM offline agent built into WanGP that orchestrates generation jobs and tedious tasks like transcription, video splitting, masking, and audio mixing while you're away.
Size
98.9 MB
Stars
10.6K
Updated
CommitOct 17
Age
1y
Commits · 90 Days