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
这是什么?WanGP 是一个一站式开源应用,用于运行顶级的视频、图像和音频/TTS 生成式 AI 模型,专为配置普通的消费级 GPU(“GPU Poor”,指显卡配置较低的用户)打造。
它是一个库,还是开箱即用的应用?它是一个开箱即用的网页应用,带有完整的 Gradio 浏览器界面,还提供无界面/CLI 模式和 API,方便把生成能力集成到你自己的应用中。
怎么让它跑起来?按照 README 中的 Quick Start / Installation 章节安装依赖并启动网页界面;模型文件随后会根据你的硬件自动下载。
我需要什么硬件——需要顶级的 Nvidia 显卡吗?不需要,它就是为低显存配置设计的:有些模型仅需 6GB 显存即可运行,还支持较旧的 Nvidia 显卡(GTX 10XX、RTX 20XX+)以及 AMD GPU(RDNA 2/3/3.5/4)。
WanGP 真的免费吗?以后会要我付费吗?本地使用免费,官方项目声明在自己的机器上运行它永远不会收取许可费、订阅费或捐款;要当心打着 WanGP 名号的第三方网站。
开箱即用能运行哪些模型?它支持的模型范围极广,包括 Wan 2.1/2.2、MiniMax H3、LTX-2/2.3/2.5、Hunyuan Video、Krea 2、Qwen Image、Flux 1/2,以及 Qwen3 TTS、Ace Step、Chatterbox 等音频/TTS 模型。
所有东西都在本地运行吗?数据会发到服务器吗?生成在你自己的 GPU 上本地运行;唯一类似服务器的功能是可选地让其他设备远程访问你自己的运行实例。
这里的 LoRA 定制是干什么用的?你可以用 LoRA 对任何受支持的模型做风格或角色控制,还可以复用你在其他应用中已经保存的 LoRA。
不用界面也能批量处理任务吗?可以,无界面模式让你直接从命令行批量启动图像、视频或音频生成任务,还有生成队列可以排好任务,在你不在时继续运行。
它自带哪些内置编辑工具?它包括遮罩编辑器、背景移除、姿态/深度/光流提取器、说话人分离、上采样(RIFE、FlashVSR、Lanczos),以及配乐重封装、通过 SeedVC 替换人声等音频工具。
Deepy 是什么?Deepy 是 WanGP 内置的低显存离线智能体,能在你不在时统筹生成任务,以及转写、视频切分、遮罩、混音等繁琐工作。
Size
98.9 MB
Stars
10.6K
Updated
CommitOct 17
Age
1y
Commits · 90 Days