Axelera AI

This page details installation procedures for the Axelera runtime in PySDK.

Power cycle the system with the Axelera accelerator to reinitialize the device.

Installing the Axelera Runtime and Driver

The following instructions will only install the necessary drivers to use the Axelera AI chip, and will not install the full version of Axelera AI's Voyager SDK. If you wish to install the full SDK, please read their installation instructions.

1

Create the keyring directory if it doesn't exist.

sudo mkdir -p "$(dirname "/etc/apt/keyrings/axelera.gpg")"

2

Download and store the GPG key.

curl -fsSL "https://software.axelera.ai/artifactory/api/security/keypair/axelera/public" | gpg --dearmor | sudo tee "/etc/apt/keyrings/axelera.gpg" > /dev/null

3

Ensure correct permissions for the key.

sudo chmod 644 "/etc/apt/keyrings/axelera.gpg"

4

Add the repository source.

echo "deb [signed-by=/etc/apt/keyrings/axelera.gpg] https://software.axelera.ai/artifactory/axelera-apt-source/ stable main" | sudo tee "/etc/apt/sources.list.d/axelera.list" > /dev/null

5

Update APT.

sudo apt update

6

Install the packages with specific versions.

sudo apt install -y axelera-runtime-1.3.3 axelera-device-1.3.3 metis-dkms=1.0.3 axelera-riscv-gnu-newlib-toolchain-409b951ba662-7

7

Add Axelera runtime libraries to ldconfig

echo "/opt/axelera/runtime-1.3.3-1/lib" | sudo tee /etc/ld.so.conf.d/axelera.conf > /dev/null
sudo ldconfig

8

Perform a hard reset (power cycle) of your system. A regular restart will prevent the Metis driver from loading correctly.