Installation

Install the AXP CLI

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

Every install verifies the CLI binary's SHA-256 checksum; if gpg is installed, the installer also verifies the binary signature.

What the installer does

1. Downloads the binary from https://download.514.ax/<channel>/<version>/<target>/ax.
2. Verifies the SHA-256 checksum, and (when gpg is present) the GPG signature.
3. Installs the binary under ~/.fiveonefour/versions/axp/<channel>/<version>/.
4. Writes a version-pinning wrapper at ~/.fiveonefour/bin/ax.
5. Puts ax on your PATH — either by symlinking into a writable directory already on PATH (~/.local/bin, ~/bin, /usr/local/bin, or /opt/homebrew/bin), or by appending a PATH export to ~/.zshrc / ~/.bashrc.

Install methods

Homebrew (macOS + Linux)

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

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

Upgrade later with brew upgrade ax, and remove it with brew uninstall ax. Brew downloads the same signed, checksum-verified binary as the installer script, and prints the same post-install next steps (sign-up, sign-in, and first-experiment guidance). It tracks the stable channel only — to install a specific version, a dev build, or a branch build, use the curl installer (see Versions). The Homebrew install does not create the AX_VERSION / .ax-version version-pinning wrapper; pin versions with the installer instead.

Sign up and connect the CLI

Request access: https://app.514.ax/sign-up

Sign in from the CLI:

ax auth login

Then continue with Getting Started.

Install options

Versions

Use a version from --list, for example:

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

List available versions:

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

Check the active CLI version with ax --version. Update to the latest stable release with ax update.

Version pinning

The curl installer writes a version-pinning wrapper at ~/.fiveonefour/bin/ax. On each invocation the wrapper picks which installed binary to run:

1. AX_VERSION (or the legacy AXP_VERSION) — an env var set to a version string or branch:<name>.
2. .ax-version — a pin file in the current directory or any parent (first line is the version). The legacy name .axp-version is still honored.
3. Otherwise the most recently installed stable-current (then dev-current) binary.

If the pinned version is not already cached under ~/.fiveonefour/versions/axp/, the wrapper downloads and installs it automatically.

Homebrew installs do not use this wrapper — pin with the curl installer when you need a fixed version.

Install location

By default, AXP 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. Disable with:

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

When logged in, CLI events include your saved user ID, email, and org ID; otherwise machine_id is used as a fallback. Disable with:

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 binary and checksum should always match.

List available versions

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

Pass stable, dev, or all after --list to narrow the channel.

Uninstall

Uninstall the wrapper and cached AXP versions:

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

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