Skip to main content

Installation

The canonical channel

cargo install axon-lang

That installs the axon binary. The crate publishes as axon-lang; the library import is use axon::*.

Prerequisites

RequirementWhy
Rust 1.95+The rust-version in every manifest. An older toolchain fails with an MSRV error, not a compile error.
A working C compiler (MSVC / clang / gcc)ring — reached through rustls, which is how this compiler speaks HTTPS to every model provider — compiles C unconditionally in its build script. On Windows the MSVC Build Tools suffice; on Debian or Ubuntu, build-essential.

These are checked at build time, not install time. If cargo install stops with a cc or linker error rather than a Rust error, the C toolchain is what is missing.

Features

The default install is the compiler and the governance CLI — check, compile, run, dossier, sbom, audit, pcc prove, pcc verify — and it adds no dependencies beyond that. Everything heavier is opt-in:

FeatureWhat it turns onWhat it costs
cli (default)the compiler + governance surface
serverthe HTTP / SSE / NDJSON / WebSocket server, and the axon-server binarythe axum service stack
postgresthe axonstore data plane against real PostgreSQL~36 crates — the single largest lever on install time
documentsthe OOXML surface and axon evidence-packagepure-Rust compression
csys-nativethe C23 kernels: exact BPE token counts, the crypto boundaryneeds a C toolchain

Leaving csys-native off is bounded and labelled, not silent: count_tokens returns an estimate instead of an exact BPE count, and mandate drops its Tier 1 logit-bias bans — while Tier 2, the refinement loop that is the guarantee, is untouched.

Verify the install

axon --version
axon check app.axon

Both axon --version and axon version print the same string.