# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.degirum.com/pysdk/runtimes-and-drivers/axelera.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.