Spaces:
Runtime error
Installation and Setup Instructions
Zluda is a CUDA emulator that supports a select number of modern AMD GPUs. The following guide is for Windows installation of Zluda.
1. Install VC++ Runtime
Download and install the VC++ Runtime from this link.
2. Install HIP SDK
Read the System Requirements
Check the "Windows-supported GPUs" section to determine the correct installation steps:
2.1 If your GPU has a green checkbox in the HIP SDK column:
- Install either v6.1.2 or v5.7.1 HIP SDK from AMD ROCm Hub
2.2 If your GPU is RX 6600, 6600XT, 6650XT, 6700, 6700XT, 6750XT:
- Install v5.7.1 HIP SDK from AMD ROCm Hub
- For 6700, 6700XT, 6750XT, download gfx1031 archive
- For 6600, 6600XT, 6650XT, download gfx1032 archive
Steps:
a. Rename
C:\Program Files\AMD\ROCm\5.7\bin\rocblas\library
tolibrary.old
b. Create a new folder namedlibrary
c. Unzip the content of the archive into that folder
2.3 For all other AMD GPUs: find gfxNNNN value for your GPU by googling "techpowerup your_gpu" (listed under "Shader ISA" on the page).
2.3.1 For gfx803, gfx900, gfx906, gfx1010, gfx1011, gfx1012, gfx1030, gfx1100, gfx1101, gfx1102
GPUs:
- Install v5.7.1 HIP SDK from AMD ROCm Hub
- Download this archive
Steps:
a. Rename
C:\Program Files\AMD\ROCm\5.7\bin\rocblas\library
tolibrary.old
b. Unzip the content of the archive intoC:\Program Files\AMD\ROCm\5.7\bin\rocblas\
2.3.2 Other GPUs
- Visit this repository with a collection of tensile libraries
- Follow the description there.
3. Installing Applio
3.1 Install [Python 3.10.11] https://www.python.org/ftp/python/3.10.11/python-3.10.11-amd64.exe
- check "Add Python to Path"
3.2 Download Applio v3.2.5 or higher source code zip Applio's release page, unzip to the desired folder.
3.3 Edit run-install.bat
and update the Torch URL from cu121
to cu118
pip install torch==2.3.1 torchvision torchaudio --upgrade --index-url https://download.pytorch.org/whl/cu121
3.4 Execute run-install.bat
to install the required python libraries.
3.5. If installation completes without errors proceed to the next step
4. Download Zluda and Patch Torch Libraries
4.1 move all .bat files from assets\zluda
to root Applio folder
4.2 For HIP SDK 5.7:
- Run
patch_zluda_hip57.bat
. - Add
C:\Program Files\AMD\ROCm\5.7\bin
to your system's Path environment variable.
4.3 For HIP SDK 6.1:**
- Run
patch_zluda_hip61.bat
. - Add
C:\Program Files\AMD\ROCm\6.1\bin
to your system's Path environment variable.
5. Starting Applio
It is assumed your primary AMD GPU has index 0. If by some reason your iGPU is listed first under 'Display Adapters' in Device manager, edit the run-applio-amd.bat
file and change the value from "0" to "1".
Execute run-applio-amd.bat
to start Applio.
6. Initial Compilation
Any time Zluda emulator meets a previously unseen computational task it compiles the kernel code to support it. During this time there's no output and Applio appears to be frozen. The compilation time takes 15..20 minutes.