Skip to main content
Question

SDK 1.4.2 installed successfully on Metis, but ax_runner module missing

  • November 5, 2025
  • 3 replies
  • 79 views

Forum|alt.badge.img

Hi it’s still me haha,

I’ve successfully installed the Voyager SDK v1.4.2 directly on my Metis Compute Board (Voyager Linux 1.0, Ubuntu 22.04 arm64 base).
The full installation (install.sh --runtime --development) completed without any critical errors, and all Axelera packages (runtime, compiler, qtools, etc.) appear correctly in the Python environment.

However, when I activate the SDK virtual environment and try to run: 

python3 -m ax_runner --help

i get : 

No module named ax_runner

Here’s a summary of my setup and verification steps:

✅ Environment 

cat /etc/os-release
lsb_release -a

✅ Installation 

cd ~/voyager-sdk
bash install.sh --runtime --development
source venv/bin/activate

The install completed with: 

Installation complete. To activate the environment, type:
  source venv/bin/activate
WARNING: Failed to refresh pcie and firmware

✅ Packages installed 

pip list | grep axelera

→ returns: 

axelera-aipu-aingine-api     0.3.0rc1.post3.dev0+def3e9a
axelera-aipu-api             3.1.0rc3.post1.dev0+6327ad4
axelera-codegen              1.4.2
axelera-compiler             1.4.2
axelera-miraculix            0.3.0
axelera-onnx-graph-cleaner   1.4.2
axelera-onnx2torch           1.4.2
axelera-qtools-tvm-interface 1.4.2
axelera-qtoolsv2             1.4.2
axelera-runtime              1.4.2
axelera_tvm                  1.4.2
axelera-types                1.4.2

❌ Issue

ax_runner is not installed in the venv: 

find ~/.cache/axelera/venvs/ -type f -name "ax_runner*.py"

→ returns nothing.

Attempting to install it manually fails: 

pip install ax_runner --extra-index-url https://software.axelera.ai/artifactory/api/pypi/axelera-pypi/simple

→ 

ERROR: No matching distribution found for ax_runner

🔍 Runtime path checks 

ls -R /opt/axelera/runtime-1.4.2-1 | grep ax_runner
find /opt/axelera/runtime-1.4.2-1 -name "*.whl"

Both return no ax_runner package inside the runtime folder.

🧩 Summary

So far:

  • SDK 1.4.2 installs completely (runtime + development OK)

  • All core Python libs (axelera-compiler, qtools, runtime, etc.) are available

  • But ax_runner (needed to run python3 -m ax_runner) is missing from both the venv and /opt/axelera

  • My Artifactory token is valid and allows access to the private repo

Could you please confirm:

  1. If ax_runner should still be part of SDK 1.4.2 for Metis (Ubuntu arm64) installations?

  2. If it’s expected to be installed automatically, in which package or path can I find it?

  3. If needed, how can I manually link it or re-run only that component?

Thanks a lot for your help,
Thibaut

3 replies

manubot
Axelera Team
  • Axelera Team
  • November 5, 2025

Hi Thibault, thanks for posting!

There is nothing called ax_runner in our SDK - can you provide more context about what you are trying to achieve?

 

Have you tried following this guide here?

https://github.com/axelera-ai-hub/voyager-sdk/blob/release/v1.4/docs/tutorials/quick_start_guide.md#run-a-metis-accelerated-pipeline

Thanks,
Manuel


Forum|alt.badge.img
  • Author
  • Ensign
  • November 5, 2025

Hey !

Thanks for your quick answer,

I tried but it keepens telling me this error about a missing file : 

Traceback (most recent call last):
  File "/home/ubuntu/voyager-sdk/./inference.py", line 11, in <module>
    from tqdm import tqdm
ModuleNotFoundError: No module named 'tqdm'

 


manubot
Axelera Team
  • Axelera Team
  • November 5, 2025