Installation

Quick install

bash <(curl -fsSL https://dl.514.ax/install.sh) axax --help

Then join the waitlist for an account, and sign in with ax auth login.

What the install script does

1. Downloads the release archive for your OS/arch and verifies its SHA-256 checksum (and GPG signature when gpg is present).
2. Installs it under ~/.fiveonefour/versions/axp/<channel>/<version>/.
3. Writes a version-pinning wrapper at ~/.fiveonefour/bin/ax and puts ax on your PATH (a symlink into a directory already on PATH, or a PATH export appended to your shell rc).

Install with Homebrew

If you use Homebrew (including Linuxbrew), install the latest stable CLI from our tap:

brew install 514-labs/tap/ax
ax --help

Then join the waitlist for an account, and sign in with ax auth login.

Homebrew tracks the latest stable release only. To install a specific version, a dev or branch build, or to pin versions, use Quick install.

Versions

Install a specific version by appending the version identifier to the quick install command:

bash <(curl -fsSL https://dl.514.ax/install.sh) ax@0.4.0-rp

List available versions (pass stable, dev, or all after --list to narrow the channel):

bash <(curl -fsSL https://dl.514.ax/install.sh) --list

Check the active version:

ax --version

Update to the latest stable release:

ax update

Homebrew installs update with brew upgrade ax instead.

Version pinning

The ax command is a small wrapper. Each run, it takes the version from the first of these it finds:

1. the AX_VERSION env var (a version id or branch:<name>)
2. the nearest .ax-version file
3. the latest installed stable

A pinned version you don't have yet is downloaded on first use. Legacy AXP_VERSION and .axp-version still work. Homebrew installs skip the wrapper.

Install location

By default, AX installs into ~/.fiveonefour. Set FIVEONEFOUR_HOME before running the installer if you need a different install root.

Telemetry

The installer, uninstaller, and CLI may send product telemetry. When logged in, CLI events include your saved user ID, email, and org ID; otherwise machine_id is used as a fallback.

Disable it for the installer:

DO_NOT_TRACK=1 bash <(curl -fsSL https://dl.514.ax/install.sh) ax

Disable it for a CLI run:

DO_NOT_TRACK=1 ax experiment run experiment.yaml

For persistent opt-out, set telemetry_enabled = false in ~/.fiveonefour/config.toml.

Troubleshooting

ax: command not found after install

The installer writes the wrapper to ~/.fiveonefour/bin/ax. If that directory was not already on PATH, it either symlinks into a PATH directory or appends an export to your shell rc.

Open a new shell, or source the rc file the installer updated:

# zsh
source ~/.zshrc

# bash
source ~/.bashrc

Or add the path for the current session:

export PATH="$HOME/.fiveonefour/bin:$PATH"
ax --help

If you installed with FIVEONEFOUR_HOME=<path>, use <path>/bin instead. See also Troubleshooting.

Checksum mismatch

If SHA-256 verification fails, retry the install. A transient download glitch is the usual cause. If it fails again with the same digest error, report it — the published archive and checksum should always match.

Uninstall

Uninstall the wrapper and cached AX versions:

bash <(curl -fsSL https://download.514.ax/uninstall.sh) --yes

Homebrew installs uninstall with brew uninstall ax instead.

The uninstaller removes installer-managed files only. Other files under ~/.fiveonefour, such as credentials or config, are left in place.