An automated setup script to install and run Wan2GP locally on Windows. Generate AI videos directly on your NVIDIA GPU without manual command-line configuration.
🎉 Welcome to v2: This release is a complete, ground-up rewrite that replaces silent command-line hangs with a clean, resilient setup experience. v2 introduces real-time download progress for multi-gigabyte files, automatic GPU-to-CUDA hardware matching, comprehensive session logging, and an interactive launcher menu to easily Update or Repair your setup without redownloading model weights.
- Download: Grab the latest
Wan2GP_OneClick_Installer_v2.batfrom this repository (or download the.ziparchive from Releases and extract it). - Run: Double-click the
.batfile (no admin rights needed to start). - Follow the On-Screen Prompts:
- Keep an eye on your taskbar—if Git or Python needs to install, Windows will ask for permission (UAC prompt).
- A live progress bar will track your download status for PyTorch and other dependencies.
- Create: Once setup completes, Wan2GP opens automatically in your browser at
http://localhost:7860.
🛡️ Note on Windows Security / SmartScreen:
Because this is a downloadable script, Windows may show a blue popup stating "Windows protected your PC". Click More info → Run anyway to continue. If the file refuses to open, right-click the.batfile, select Properties, check Unblock at the bottom, and click Apply.
Re-opening the app later: Double-click the
.batfile anytime. A menu will appear with options to Launch, Update, or Repair your setup.
| Component | Minimum Requirement | Notes |
|---|---|---|
| Operating System | Windows 10 / 11 (64-bit) | |
| Graphics Card (GPU) | NVIDIA RTX 20-series or newer | RTX 30, 40, and 50-series fully supported |
| Drivers | Latest NVIDIA Drivers | Download from NVIDIA |
| Storage | 50 GB+ free disk space | Required for AI video model weights |
| Internet | Stable broadband | Downloads large model packages |
You do not need to install Python, Git, or CUDA libraries beforehand. The script automatically handles:
- Installing Python 3.10 and Git (if not already found).
- Detecting your specific GPU and matching the optimal PyTorch + CUDA version.
- Downloading the latest Wan2GP source code and libraries.
- Enabling speed optimizations (SageAttention and Triton) if your card supports them.
❌ "No NVIDIA GPU detected" or Driver Errors
- Ensure you have an NVIDIA card installed (AMD and Intel GPUs are not supported).
- Update your GPU drivers from nvidia.com/drivers, reboot your PC, and launch the installer again.
🛡️ Installer Hangs during Git/Python Setup
- Check your Windows taskbar for a flashing blue-and-yellow shield icon.
- Windows often opens permission (UAC) prompts minimized in the background. Click it and select Yes to continue.
🌐 Port 7860 Already in Use
- An instance of Wan2GP (or another local tool like Stable Diffusion) is already running.
- Close existing browser and terminal windows, or terminate background Python processes in Task Manager.
⚠️ Package ABI Mismatch (WinError 127)
- Run the
.batfile again and choose Option 3: Repair. This rebuilds your virtual environment cleanly without deleting your downloaded model weights.
📁 Where are files and error logs stored?
Everything installs to your user folder:
- App files:
%USERPROFILE%\Wan2GP\ - Error & Run Logs:
%USERPROFILE%\Wan2GP\logs\ - To completely uninstall: Delete the
%USERPROFILE%\Wan2GP\folder.
The installer uses a hybrid .bat launcher wrapping embedded PowerShell execution:
- Absolute Path Execution: Avoids PATH conflicts by invoking
$VenvDir\Scripts\python.exedirectly rather than relying onactivate.bat. - Dynamic GPU Matrix: Maps compute capability directly to compatible PyTorch, CUDA, Triton, and SageAttention binaries.
- Deterministic Flags: Probes once for optional dependencies to avoid cascading crash loops.
%USERPROFILE%\Wan2GP\
├── source/ # Wan2GP repository clone
├── venv/ # Python virtual environment
├── logs/ # Transcript and pip logs
└── .installed # Installation metadata flag
$python = "$env:USERPROFILE\Wan2GP\venv\Scripts\python.exe"
& $python "$env:USERPROFILE\Wan2GP\source\wgp.py" --open-browser
Edit the # Configuration block at the top of the script to adjust parameters:
$PythonVersion = '3.11.0' # Change Python version
$MinFreeGB = 100 # Change minimum disk space check
- Installer: Released under the MIT License.
- Core Application: See the original Wan2GP Repository for upstream model licenses and codebase documentation.