Applio
Getting Started

Installation

Applio is easy to install. We recommend the precompiled version for new users as it's ready to use.

Download Applio

  1. Get the latest .bat file from the GitHub releases.
  2. Extract the zip file.

Prepare for Installation

  • Place Applio in a folder on the C drive.
  • Avoid folders with privileged access.
  • Don't run as administrator.
  • Ensure the path has no spaces or special characters.
  • Temporarily disable antivirus and firewall.

Install and Run

  1. Run run-install.bat and wait for it to complete.
  2. Run run-applio.bat to start Applio.

Alternative Installation Methods

Precompiled Zip Version

Download Applio

  1. Get the latest precompiled zip file from Hugging Face.
  2. Extract the zip file into a folder.

Run Applio

  1. Run run-applio.bat to start Applio.

Pinokio

You can also easily install Applio using the Pinokio launcher. It is compatible with both Windows and Linux/macOS.

AMD GPU Support (Windows)

For AMD GPU users, follow these steps to set up Applio using Zluda:

Install VC++ Runtime

  1. Download and install the VC++ Runtime.

Install HIP SDK

  1. Check the System Requirements.

  2. In the "Windows-supported GPUs" section, determine your installation steps:

    a. 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.

    b. 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.
    • Rename C:\Program Files\AMD\ROCm\5.7\bin\rocblas\library to library.old.
    • Create a new folder named library.
    • Unzip the content of the archive into that folder.

    c. For all other AMD GPUs:

    • Find your gfxNNNN value by searching "techpowerup your_gpu" (listed under "Shader ISA" on the page).
    • 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.
      • Rename C:\Program Files\AMD\ROCm\5.7\bin\rocblas\library to library.old.
      • Unzip the content of the archive into C:\Program Files\AMD\ROCm\5.7\bin\rocblas\.
    • For other GPUs:

Install Applio

  1. Download a compiled version of Applio v3.2.5 or higher, unzip to the desired folder.
  2. Using command line from the Applio folder run 
    env\python -m pip uninstall torch torchvision torchaudio
env\python -m pip install torch==2.3.1 torchvision==0.18.1 torchaudio==2.3.1 --upgrade --index-url https://download.pytorch.org/whl/cu118

Set up Zluda and Patch Torch Libraries

  1. Move all .bat files from assets\zluda to the root Applio folder.
  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.
  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.

Start Applio

  1. It's assumed your primary AMD GPU has index 0. If 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".
  2. Run run-applio-amd.bat to start Applio.

Initial Compilation

Note that the first time Zluda encounters a new computational task, it compiles the kernel code. During this time, there's no output and Applio may appear frozen. Initial compilation can take 15-20 minutes.

Updating and Uninstalling

  • To update: Delete the current Applio folder and reinstall. Save your audios and models first.
  • To uninstall: Simply delete the Applio folder.

Previous

Make your first model

Next

Inferencing

On this page