# Axelera AI

{% hint style="info" %}
Power cycle the system with the Axelera accelerator to reinitialize the device.
{% endhint %}

## 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](https://github.com/axelera-ai-hub/voyager-sdk/blob/release%2Fv1.4/docs%2Ftutorials%2Finstall.md).

{% stepper %}
{% step %}
Create the keyring directory if it doesn't exist.

{% code overflow="wrap" %}

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

{% endcode %}
{% endstep %}

{% step %}
Download and store the GPG key.

{% code overflow="wrap" %}

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

{% endcode %}
{% endstep %}

{% step %}
Ensure correct permissions for the key.

{% code overflow="wrap" %}

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

{% endcode %}
{% endstep %}

{% step %}
Add the repository source.

{% code overflow="wrap" %}

```bash
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
```

{% endcode %}
{% endstep %}

{% step %}
Update APT.

{% code overflow="wrap" %}

```bash
sudo apt update
```

{% endcode %}
{% endstep %}

{% step %}
Install the packages with specific versions.

{% code overflow="wrap" %}

```bash
sudo apt install -y axelera-runtime-1.4.0 axelera-device-1.4.0 metis-dkms=1.2.2 axelera-riscv-gnu-newlib-toolchain-409b951ba662-7
```

{% endcode %}
{% endstep %}

{% step %}
Add Axelera runtime libraries to ldconfig

{% code overflow="wrap" %}

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

{% endcode %}
{% endstep %}

{% step %}
Perform a hard reset (power cycle) of your system. A regular restart will prevent the Metis driver from loading correctly.
{% endstep %}
{% endstepper %}