Manual Installation

The main Installation Instructions page shows a one-step installation process that checks the prerequisite and installs Quark quantizer and Vitis AI execution provider.

This page explains how to install each component manually.

Note

Make sure to follow the installation steps in the order explained below.

Perform a Default Installation

Download the ryzen-ai-rt-1.3.0.1-20241217.msi installer.

Install the RyzenAI Software using the default settings.

This will copy in the C:\Program Files\RyzenAI\1.3.0 folder all the files required for a manual installation.

Create a Conda Environment

The Ryzen AI Software requires using a conda environment (Anaconda or Miniconda) for the installation process.

Start a conda prompt. In the conda prompt, create and activate an environment for the rest of the installation process.

conda create --name <name> python=3.10
conda activate <name>

Set Environment Variables

Configure the environment variables to be automatically set upon activation of the conda environment.

First, create a directory for the activation scripts:

mkdir %CONDA_PREFIX%\etc\conda\activate.d

Create script to load RYZEN_AI_INSTALLER_PATH environment. This script will be executed every time the conda environment is activated.

notepad %CONDA_PREFIX\etc\conda\activate.d\load_ryzenai_installer_path.bat

Add the following line to the script:

set "RYZEN_AI_INSTALLER_PATH=%RYZEN_AI_INSTALLER_PATH%"

Set the XLNX_VART_FIRMWARE environment variable based on your APU type:

For STX/KRK APUs:

set XLNX_VART_FIRMWARE=%RYZEN_AI_INSTALLATION_PATH%/voe-4.0-win_amd64/xclbins/strix/AMD_AIE2P_Nx4_Overlay.xclbin

For PHX/HPT APUls:

set XLNX_VART_FIRMWARE=%RYZEN_AI_INSTALLATION_PATH%/voe-4.0-win_amd64/xclbins/phoenix/1x4.xclbin

Install Quark Quantizer

Install Quark quantizer wheel

cd %RYZEN_AI_INSTALLATION_PATH%
pip install quark-0.6.0-py3-none-any.whl

Install the Vitis AI Execution Provider

cd %RYZEN_AI_INSTALLATION_PATH%
pip install voe-1.3.0-cp310-cp310-win_amd64.whl
pip install onnxruntime_vitisai-1.19.0-cp310-cp310-win_amd64.whl
pip install numpy==1.26.4

Optional: Install the AI Analyzer

cd %RYZEN_AI_INSTALLATION_PATH%
pip install aianalyzer-1.3.0-py3-none-any.whl

Runtime Setup

Set the following environment variable in the conda environment created above:

For STX/KRK: (default)

set XLNX_VART_FIRMWARE=%RYZEN_AI_INSTALLATION_PATH%\voe-4.0-win_amd64\xclbins\strix\AMD_AIE2P_Nx4_Overlay.xclbin

For PHX/HPT:

set XLNX_VART_FIRMWARE=%RYZEN_AI_INSTALLATION_PATH%\voe-4.0-win_amd64\xclbins\phoenix\1x4.xclbin

The *.xclbin files are located in the voe-4.0-win_amd64\xclbins folder of the Ryzen AI Software installation package. For detailed information and other available options refer to the Runtime Setup page.

Test the Installation

The Ryzen AI Software installation folder contains a test to verify that the Ryzen AI software is correctly installed. Instructions on how to run this test can be found here.