Installation Instructions#

Supported Configurations#

The Ryzen AI Software supports the following processors running Windows 11 (Win 11 build>=22621.3527 is required for Ryzen AI Software 1.2.)

  • Phoenix (PHX): AMD Ryzen™ 7940HS, 7840HS, 7640HS, 7840U, 7640U.

  • Hawk (HPT): AMD Ryzen™ 8640U, 8640HS, 8645H, 8840U, 8840HS, 8845H, 8945H.

  • Strix (STX): AMD Ryzen™ Ryzen AI 9 HX370, Ryzen AI 9 365

The rest of this document will refer to Phoenix as PHX, Hawk as HPT, and Strix as STX.

Note

In this documentation, “NPU” is used in descriptions, while “IPU” is retained in the tool’s language, code, screenshots, and commands. This intentional distinction aligns with existing tool references and does not affect functionality. Avoid making replacements in the code.

Prerequisites#

To enable the development and deployment of applications leveraging the NPU, you must have the following software installed on the system.

Dependencies

Version Requirement

Visual Studio

2022

cmake

version >= 3.26

Anaconda or Miniconda

Latest version

⚠ IMPORTANT:

  • Visual Studio 2022 Community: ensure that “Desktop Development with C++” is installed

  • Anaconda or Miniconda: ensure that the following path is set in the System PATH variable: path\to\anaconda3\Scripts or path\to\miniconda3\Scripts (The System PATH variable should be set in the System Variables section of the Environment Variables window).


Install NPU Drivers#

  • Download the NPU driver installation package NPU Driver

  • Install the NPU drivers by following these steps:

    • Extract the downloaded NPU_RAI1.2.zip zip file.

    • Open a terminal in administrator mode and execute the .\npu_sw_installer.exe exe file.

  • Ensure that NPU MCDM driver (Version:32.0.201.204, Date:7/26/2024) is correctly installed by opening Device Manager -> Neural processors -> NPU Compute Accelerator Device.

Install the Ryzen AI Software#

  • Download the RyzenAI Software MSI installer ryzenai-1.2.0.msi.

  • Launch the MSI installer and follow the instructions on the installation wizard:

    • Accept the terms of the End User License Agreement.

    • Provide the destination folder for Ryzen AI installation (default: C:\Program Files\RyzenAI\1.2.0)

    • Specify the name for the conda environment (default: ryzen-ai-1.2.0)

The Ryzen AI Software packages are now installed in the conda environment created by the installer. Refer to the Runtime Setup page for more details about setting up the environment before running an inference session on the NPU.

📝 NOTE: This installation is only for CNN models. The LLM models flow installation is hosted in the GitHub repo; for details, please check LLM Flow

Test the Installation#

The Ryzen AI Software installation folder contains test to verify that the software is correctly installed. This installation test can be found in the quicktest subfolder.

  • Open a Conda command prompt (search for “Anaconda Prompt” in the Windows start menu)

  • Activate the Conda environment created by the Ryzen AI installer:

conda activate <env_name>

  • Run the test:

cd %RYZEN_AI_INSTALLATION_PATH%/quicktest
python quicktest.py

  • The quicktest.py script sets up the environment and runs a simple CNN model. On a successful run, you will see an output similar to the one shown below. This indicates that the model is running on the NPU and that the installation of the Ryzen AI Software was successful:

[Vitis AI EP] No. of Operators :   CPU     2    IPU   398  99.50%
[Vitis AI EP] No. of Subgraphs :   CPU     1    IPU     1 Actually running on IPU     1
...
Test Passed
...

Additional Considerations#

  • The full path to the Ryzen AI Software installation folder is stored in the RYZEN_AI_INSTALLATION_PATH environment variable.

  • To install the Ryzen AI Software in a pre-existing conda environment, follow the Manual Installation instructions.

  • If you need to install the Vitis AI PyTorch/TensorFlow Quantizer or the Microsoft Olive Quantizer, refer to the Other Quantizers page.