Axiomate

Installing on Linux

On Linux, install manually from a downloaded release archive. The archive is built on Ubuntu 24.04 (x64).

System requirements

  • Architecture: x64
  • glibc: 2.39 or later (the archive is built on Ubuntu 24.04 and dynamically links its glibc at runtime)
  • Required dependency: Git
  • Optional dependency: Python 3.12+ (some skills are Python scripts; install as needed)

Compatible distributions

Any x64 distribution with glibc ≥ 2.39 works. Common compatible ones:

  • Ubuntu 24.04 LTS and later (including derivatives such as Linux Mint 22 and Pop!_OS 24.04)
  • Debian 13 (Trixie) and later
  • Fedora 40 and later
  • RHEL / Rocky / AlmaLinux 10 and later
  • Rolling releases (Arch Linux, openSUSE Tumbleweed, etc.)

The following are not compatible due to an older glibc: Ubuntu 22.04 (glibc 2.35), Debian 12 (2.36), RHEL / Rocky 9 (2.34), and similar. musl-based distributions (such as Alpine) are not supported. Run ldd --version to check your system's glibc version.

arm64 is not yet available: no arm64 build is published yet. If you need arm64, contact us.

Computer Use (desktop automation) is not included: it is available on Windows and macOS only. The Linux desktop is highly fragmented (X11 / Wayland, many desktop environments and window managers), with no single stable automation interface, so it is not supported for now.

Installation steps

  1. Make sure Git is installed (on Debian / Ubuntu: sudo apt update && sudo apt install -y git; on Fedora: sudo dnf install git).

  2. Download the Linux archive from the download page. It is named like axiomate-<version>-linux-x64.tar.gz. Extract it to a directory you'll keep:

    mkdir -p ~/axiomate
tar -xzf ~/Downloads/axiomate-*-linux-x64.tar.gz -C ~/axiomate

  3. Add the executable's directory to your PATH (for bash; zsh users write to ~/.zshrc):

    echo 'export PATH="$HOME/axiomate:$PATH"' >> ~/.bashrc
source ~/.bashrc

Axiomate is still in beta. If you hit old-data compatibility issues after upgrading to a new version, you can delete the old ~/.axiomate/ directory and the ~/.axiomate.json config file to clear the old data. Back them up first if they contain important items, such as skills or model config.

Verification

axiomate --help

If the help output appears, the installation succeeded. Next, configure a model to start using it.

Uninstalling

The Linux build is installed manually, so uninstalling is manual too:

  1. Delete the extracted install directory (e.g. ~/axiomate).
  2. Remove the PATH entry that was added during install. Edit ~/.bashrc (or ~/.zshrc), delete the line marked # Added by Axiomate installer, then reopen your terminal.
  3. Optional: delete your personal data ~/.axiomate.json and ~/.axiomate/ for a full cleanup.