File size: 4,659 Bytes
3ea2ecf |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 |
# Installation Guide
This guide covers installation for specific RDNA3 and RDNA3.5 AMD CPUs (APUs) and GPUs
running under Windows.
tl;dr: Radeon RX 7900 GOOD, RX 9700 BAD, RX 6800 BAD. (I know, life isn't fair).
Currently supported (but not necessary tested):
**gfx110x**:
* Radeon RX 7600
* Radeon RX 7700 XT
* Radeon RX 7800 XT
* Radeon RX 7900 GRE
* Radeon RX 7900 XT
* Radeon RX 7900 XTX
**gfx1151**:
* Ryzen 7000 series APUs (Phoenix)
* Ryzen Z1 (e.g., handheld devices like the ROG Ally)
**gfx1201**:
* Ryzen 8000 series APUs (Strix Point)
* A [frame.work](https://frame.work/au/en/desktop) desktop/laptop
## Requirements
- Python 3.11 (3.12 might work, 3.10 definately will not!)
## Installation Environment
This installation uses PyTorch 2.7.0 because that's what currently available in
terms of pre-compiled wheels.
### Installing Python
Download Python 3.11 from [python.org/downloads/windows](https://www.python.org/downloads/windows/). Hit Ctrl+F and search for "3.11". Dont use this direct link: [https://www.python.org/ftp/python/3.11.9/python-3.11.9-amd64.exe](https://www.python.org/ftp/python/3.11.9/python-3.11.9-amd64.exe) -- that was an IQ test.
After installing, make sure `python --version` works in your terminal and returns 3.11.x
If not, you probably need to fix your PATH. Go to:
* Windows + Pause/Break
* Advanced System Settings
* Environment Variables
* Edit your `Path` under User Variables
Example correct entries:
```cmd
C:\Users\YOURNAME\AppData\Local\Programs\Python\Launcher\
C:\Users\YOURNAME\AppData\Local\Programs\Python\Python311\Scripts\
C:\Users\YOURNAME\AppData\Local\Programs\Python\Python311\
```
If that doesnt work, scream into a bucket.
### Installing Git
Get Git from [git-scm.com/downloads/win](https://git-scm.com/downloads/win). Default install is fine.
## Install (Windows, using `venv`)
### Step 1: Download and Set Up Environment
```cmd
:: Navigate to your desired install directory
cd \your-path-to-wan2gp
:: Clone the repository
git clone https://github.com/deepbeepmeep/Wan2GP.git
cd Wan2GP
:: Create virtual environment using Python 3.10.9
python -m venv wan2gp-env
:: Activate the virtual environment
wan2gp-env\Scripts\activate
```
### Step 2: Install PyTorch
The pre-compiled wheels you need are hosted at [scottt's rocm-TheRock releases](https://github.com/scottt/rocm-TheRock/releases). Find the heading that says:
**Pytorch wheels for gfx110x, gfx1151, and gfx1201**
Don't click this link: [https://github.com/scottt/rocm-TheRock/releases/tag/v6.5.0rc-pytorch-gfx110x](https://github.com/scottt/rocm-TheRock/releases/tag/v6.5.0rc-pytorch-gfx110x). It's just here to check if you're skimming.
Copy the links of the closest binaries to the ones in the example below (adjust if you're not running Python 3.11), then hit enter.
```cmd
pip install ^
https://github.com/scottt/rocm-TheRock/releases/download/v6.5.0rc-pytorch-gfx110x/torch-2.7.0a0+rocm_git3f903c3-cp311-cp311-win_amd64.whl ^
https://github.com/scottt/rocm-TheRock/releases/download/v6.5.0rc-pytorch-gfx110x/torchaudio-2.7.0a0+52638ef-cp311-cp311-win_amd64.whl ^
https://github.com/scottt/rocm-TheRock/releases/download/v6.5.0rc-pytorch-gfx110x/torchvision-0.22.0+9eb57cd-cp311-cp311-win_amd64.whl
```
### Step 3: Install Dependencies
```cmd
:: Install core dependencies
pip install -r requirements.txt
```
## Attention Modes
WanGP supports several attention implementations, only one of which will work for you:
- **SDPA** (default): Available by default with PyTorch. This uses the built-in aotriton accel library, so is actually pretty fast.
## Performance Profiles
Choose a profile based on your hardware:
- **Profile 3 (LowRAM_HighVRAM)**: Loads entire model in VRAM, requires 24GB VRAM for 8-bit quantized 14B model
- **Profile 4 (LowRAM_LowVRAM)**: Default, loads model parts as needed, slower but lower VRAM requirement
## Running Wan2GP
In future, you will have to do this:
```cmd
cd \path-to\wan2gp
wan2gp\Scripts\activate.bat
python wgp.py
```
For now, you should just be able to type `python wgp.py` (because you're already in the virtual environment)
## Troubleshooting
- If you use a HIGH VRAM mode, don't be a fool. Make sure you use VAE Tiled Decoding.
### Memory Issues
- Use lower resolution or shorter videos
- Enable quantization (default)
- Use Profile 4 for lower VRAM usage
- Consider using 1.3B models instead of 14B models
For more troubleshooting, see [TROUBLESHOOTING.md](TROUBLESHOOTING.md)
|