Skip to content

Install

Quick Start

HeliaAOT ships as a Python CLI and as a standalone app. Pick one of the quick paths below; advanced, from-source options are at the end.

Permissions Warning

Before installing HeliaAOT, you must be granted permission to the repository. Please reach out to the Ambiq AI team to request access or support.

Using pipx is the recommended way to install helia-aot as it allows installing and running python apps in isolated environments. Upon installation, helia-aot will be available in your PATH.

  • Install helia-aot: pipx install 'helia-aot @ git+https://github.com/AmbiqAI/helia-aot.git@main'
  • Upgrade helia-aot: pipx upgrade helia-aot
  • Invoke helia-aot: helia-aot --help
  • Remove helia-aot: pipx uninstall helia-aot

Tip

pipx requires a local Python (see requirements below), but isolates HeliaAOT from your global environment.

Download the app for your OS from the latest release page. No Python, no dependencies.

# Download an archive from the release page, then:
tar -xzf helia-aot-macos-*.tar.gz
sudo mv helia-aot /usr/local/bin/            # or any dir on your PATH
helia-aot --version
If you hit Gatekeeper warnings, either use Right click → Open once, or: 
xattr -d com.apple.quarantine /usr/local/bin/helia-aot


tar -xzf helia-aot-linux-*.tar.gz
sudo mv helia-aot /usr/local/bin/
helia-aot --version

# Unzip the archive and move the exe somewhere on PATH:
move .\helia-aot.exe "C:\Program Files\HeliaAOT\helia-aot.exe"
# Optional: add that folder to the System PATH
.\helia-aot.exe --version

Tip

Binary filenames may include the OS/arch (e.g. helia-aot-linux-x86_64.tar.gz, helia-aot-windows-x86_64.zip). View the Assets list on the release for the exact names.

If you want the latest, editable install for development, use one of the methods below.

git clone https://github.com/AmbiqAI/helia-aot.git
cd helia-aot
python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .
helia-aot --help

git clone https://github.com/AmbiqAI/helia-aot.git
cd helia-aot
uv sync
uv run helia-aot --help

Verify the install

Once installed, verify the CLI is working:

helia-aot version
helia-aot --help

You should see usage text and a semantic version. If the command isn’t found, ensure the install location is on your PATH.

Requirements

Software (tooling)

  • For pipx/pip/uv installs: Python 3.10+
  • For standalone app: no runtime dependencies

The project’s Python dependencies are listed in pyproject.toml and are automatically handled by pipx, pip, or uv.

Firmware (for generated C modules)

See platform-specific integration guides:

Usage (CLI)

$ helia-aot --help

usage: helia-aot [-h] <command> ...

positional arguments:
  <command>
    version   Display the version of the HeliaAOT library.
    convert   Convert a model to standalone C inference module.

options:
  -h, --help  show this help message and exit

See the CLI Reference for all commands and flags.

Advanced: Install from source

If you want the latest, editable install for development, use one of the methods below.

git clone https://github.com/AmbiqAI/helia-aot.git
cd helia-aot
python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -U pip setuptools wheel
pip install -e .
helia-aot --help

git clone https://github.com/AmbiqAI/helia-aot.git
cd helia-aot
uv sync
uv run helia-aot --help

Updating

  • pipx: pipx upgrade helia-aot
  • Standalone App: download the new release asset and replace the old binary
  • pip/uv dev installs: pull main and reinstall (pip install -e . or uv sync)

Uninstall

  • pipx: pipx uninstall helia-aot
  • Standalone App: delete the executable you placed on your PATH
  • pip/uv: remove the venv and repo folder

Next Steps