Install Ax from source or release binaries.

Ax needs `clang` for native linking. TLS examples also need OpenSSL development files discoverable through `pkg-config openssl`.

From Source

git clone https://github.com/axlanguage/axlang
cd axlang
cargo build --release
target/release/ax version

One Line Install

curl -fsSL https://raw.githubusercontent.com/axlanguage/axlang/main/dist/install.sh | sh

The installer downloads the matching release artifact from GitHub's latest release into $HOME/.ax/bin. Set AX_VERSION=v1.0.0 for a specific tag, AX_RELEASE_BASE for a mirror or local artifact directory, or AX_BIN_DIR for a different install directory.

Windows PowerShell

iwr https://raw.githubusercontent.com/axlanguage/axlang/main/dist/install.ps1 -useb | iex

Both installers verify SHA256SUMS when the release publishes it, and stop if the checksum does not match.

Release Binary Names

Release Automation

.github/workflows/release.yml

The release workflow builds every artifact above, runs ax version, builds and runs examples/release_smoke.ax to cover cross-platform standard packs, verifies the installers against staged artifacts, creates SHA256SUMS, uploads a combined workflow artifact, and attaches assets to GitHub releases for v* tags.

Local Release Smoke

./dist/verify-release.sh

This builds the host release artifact, installs it from dist/bin with the one-line installer path, runs ax version, lists packs, executes a native filesystem-agent sample, and runs the release standard-pack smoke.

Codex Skill

npx skills add https://github.com/axlanguage/axlang --skill ax -a codex

The skill provides Ax install, compile, check, graph, pack authoring, and agent-program workflows for Codex. It includes helper scripts for finding or installing Ax, finding or installing packs, scaffolding external packs, and running an end-to-end pack smoke.

skills/ax/scripts/ensure-ax.sh .
skills/ax/scripts/ax.sh check examples/hello.ax
skills/ax/scripts/ax.sh build examples/hello.ax
skills/ax/scripts/ax.sh run examples/hello.ax
skills/ax/scripts/pack.sh find crypto
skills/ax/scripts/pack.sh info std.crypto
skills/ax/scripts/new-pack.sh ./registry acme.telemetry telemetry.write track
skills/ax/scripts/pack-smoke.sh .

Windows Runtime Scope

Windows release binaries support the CLI and native builds for core, filesystem, crypto, environment, process, CLI args, JSON, string, path, time, URL, and async programs. TCP and HTTP network runtime files compile with explicit limited stubs on Windows; use macOS or Linux for native network execution in v1.0.