Installation Instructions

Installation Instructions#

This page covers Ryzen AI installation on Windows.

Prerequisites#

The Ryzen AI Software supports AMD processors with a Neural Processing Unit (NPU). Refer to the release notes for the full list of supported configurations.

The following dependencies must be installed on the system before installing the Ryzen AI Software:

Dependencies

Version Requirement

Windows 11

build >= 26100

cmake

version >= 3.26

Python (with venv support)

Latest version

⚠ IMPORTANT:

  • Python: ensure that the Python installation directory and its Scripts directory are available in the System PATH variable (set in the System Variables section of the Environment Variables window).


Install NPU Drivers#

  • Download the latest drivers - NPU Driver

  • AMD Software Installer - Follow the Instructions to successfully install the drivers

  • Reboot the machine

  • Open Task Manager -> Performance -> NPU0. Ensure that NPU driver (Version:32.0.201.448, Date:10/3/2026) is correct

Install Ryzen AI Software#

  • Download the Ryzen AI Software installer Ryzen AI Software Installer

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

    • Accept the terms of the Licence agreement

    • Provide the destination folder for Ryzen AI installation (default installation path: C:\Program Files\RyzenAI\ryzen-ai-1.9.0\)

    • Use the Python virtual environment provided in the installation folder

    • Note - The commands below and in this documentation are w.r.t selection of default installation path (``C:Program FilesRyzenAIryzen-ai-1.9.0``)

_images/venv-2.png

The Ryzen AI Software packages are now installed in the Python virtual environment provided by the installer.

_images/venv-3.png

Note

NuGet package is available to download at ryzen_ai_nuget_1.9.0.zip.

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 which is expected to work for Strix (STX) or newer devices.

  • Open a Windows Command Prompt

  • Activate the Python virtual environment created by the Ryzen AI installer:

"C:\Program Files\RyzenAI\ryzen-ai-1.9.0\Scripts\activate.bat"

  • Immediately after activating ryzen-ai-1.9.0 python virtual enviornment, RYZEN_AI_INSTALLATION_PATH environment variable will be set by executing the following command - set "RYZEN_AI_INSTALLATION_PATH=C:\Program Files\RyzenAI\1.9.0

  • Run the test:

cd %RYZEN_AI_INSTALLATION_PATH%/quicktest
python quicktest.py

[I:onnxruntime:, session_state_utils.cc:243 onnxruntime::session_state_utils::SaveInitializedTensors] Saving initialized tensors.
[I:onnxruntime:, session_state_utils.cc:438 onnxruntime::session_state_utils::SaveInitializedTensors] Done saving initialized tensors
[I:onnxruntime:, inference_session.cc:2532 onnxruntime::InferenceSession::Initialize] Session successfully initialized.
Test Finished

  • Verify NPU activity by opening Task Manager → Performance → NPU while the test is running. You should see NPU utilization increase during model inference.

To enable NPU offloading logs using ONNX Runtime session options, modify the quicktest.py script to include session options that control logging verbosity. The following code snippet demonstrates how to set up the session options for detailed logging:

# Create session options
session_options = ort.SessionOptions()
session_options.log_severity_level = 0  # 0=Verbose, 1=Info, 2=Warning, 3=Error, 4=Fatal

try:
    session = ort.InferenceSession(model,
                             sess_options=session_options,
                             providers=providers,
                             provider_options=provider_options)
except Exception as e:
    print(f"Failed to create an InferenceSession: {e}")
    sys.exit(1)  # Exit the program with a non-zero status to indicate an error

  • Run the updated quicktest.py script with logs filter:

cd %RYZEN_AI_INSTALLATION_PATH%/quicktest
python quicktest.py 2>&1 | findstr /i "Vitis | NPU | Test"

  • On a successful run, the output will look ssimilar 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:

[I:onnxruntime:, stat.cpp:198 stat.cpp] [Vitis AI EP] No. of Operators :
[I:onnxruntime:, stat.cpp:198 stat.cpp]    NPU   398
[I:onnxruntime:, stat.cpp:198 stat.cpp] VITIS_EP_CPU     2
[I:onnxruntime:, stat.cpp:198 stat.cpp] [Vitis AI EP] No. of Subgraphs :
[I:onnxruntime:, stat.cpp:198 stat.cpp]    NPU     1
[I:onnxruntime:, stat.cpp:198 stat.cpp] Actually running on NPU      1
[I:onnxruntime:, vitisai_compile_model.cpp:1488 vitisai_compile_model.cpp] AVG CPU Usage 4.93969%
[I:onnxruntime:, vitisai_compile_model.cpp:1489 vitisai_compile_model.cpp] Peak Working Set size 565.277 MB
[V:onnxruntime:, session_state.cc:1350 onnxruntime::VerifyEachNodeIsAssignedToAnEp]  All nodes placed on [VitisAIExecutionProvider]. Number of nodes: 3
[I:onnxruntime:, unzip.hpp:18 unzip.hpp] inflateInit successful, available input: 137827
Test finished

Note

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

Contents