Skip to content

v3.0.0 — self-contained install layout (C:\Wan2GP + C:\Wan2GP-Models)

Choose a tag to compare

View all tags
@GKartist75 GKartist75 released this 20 Aug 13:36
· 103 commits to main since this release
v3.0.0
88f227b

Wan2GP Desktop Launcher v3.0.0

📁 BREAKING: install folders moved

Wan2GP now installs to a dedicated C:\Wan2GP (repo + venv + config) and keeps
model checkpoints/LoRAs on a separate C:\Wan2GP-Models (ckpts = C:\Wan2GP-Models\ckpts)
— out of roaming AppData for good. This kills the old Wan2GP\Wan2GP doubling and keeps
tens–hundreds of GB of models off your roaming profile.

How to upgrade: uninstall (keep/delete old models) → close launcher → run the new .exe
→ point models at C:\Wan2GP-Models\ckpts. (In-place update also works — it auto-migrates
your old AppData data into C:\Wan2GP on first launch, rollback-safe.)

⚙️ Latest GPU kernels — installed per hardware (v3.0.0 versions)

The installer reads Wan2GP's setup_config.json, shows exactly what it will install, and
re-syncs these on every update:

Wheel Version (v3.0.0)
Python (uv) 3.11.14 (RTX 20–50) / 3.10.9 (GTX 10)
PyTorch + CUDA 2.10.0 + CUDA 13.0
Triton latest (3.7.1 on this build)
SageAttention 1.0.6 (RTX 20) / 2.2.0 (RTX 30–50)
Sparge Attention 0.1.0
Flash-Attention 2.8.3
Nunchaku 1.2.1
GGUF llama.cpp CUDA 1.0.11
Lightx2v (FP4) 0.0.2 — RTX 50xx / sm120+ only
bitsandbytes (NF4) 0.49.2

Per-hardware set: RTX 20 → Sage 1.0.6 + Flash 2.8.3 + Nunchaku + GGUF 1.0.11 · RTX 30/40 →
add Sparge 0.1.0 + Sage 2.2.0 · RTX 50 → add Lightx2v 0.0.2. All profiles also get bitsandbytes 0.49.2.

What's new in v3.0.0

  • Self-contained default data dir C:\Wan2GP (AppData fallback only when C:\ not writable) + one-time migration.
  • Separate C:\Wan2GP-Models\ckpts (loras/outputs); legacy repo-relative model paths upgraded.
  • EPERM-on-reinstall fixed — clone uses temp dir + mergeDir(), never renames the live data dir.
  • 3-layer warnings (install note, model-folder ⚠, dashboard MODELS banner).
  • README + infographic document the GPU kernel wheels (with versions) and map the 1-click installer to Wan2GP's manual INSTALLATION.md.
  • Credits: DeepBeepMeep (Wan2GP), Tophness / Steve Jabz (original install scripts), and all users.

Also included (from 2.6 – 2.8.7, none regressed)

  • No more black/blank screen — nested-.screen DOM regression fixed (2.8.7), GPU-compositor override (2.8.2/2.8.3), update-app.asar blank (2.8.5).
  • Cleaner HTML structure (#installer/#dashboard siblings under #app, .screen{position:absolute;inset:0}).
  • GPU kernel-wheel sync (GGUF/Nunchaku/Flash/Sage/Sparge/bitsandbytes) on every install/update.
  • Clean Desktop ↔ Dashboard switching — embedded view no longer reloads on restore, so in-page input is never dropped.

⚠️ Unsigned build (SignPath token not configured). Windows SmartScreen may warn on first run — that's expected.

Assets 5
Loading