Axiom Core
Getting Started

Installation

Getting the Axiom CLI on your machine.

The Axiom CLI is a unified tool used by both backend and frontend developers to manage behavioral contracts, build artifacts, and generate client-side code.

Install the CLI

Choose your preferred installation method. Both methods support macOS and Linux.

Run the following command in your terminal:

curl -fsSL https://axiomcore.dev/install | sh

The installer automatically sets binaries to /usr/local/bin. Because this is a system path, you will likely be prompted for your sudo password during the process.

If you use Homebrew, you can install via our official tap:

brew install AxiomCore/tap/axiom

Installing via Homebrew does not require sudo permissions as it installs within the Homebrew prefix.

Verification

Once installed, verify that the CLI is correctly configured in your environment:

axiom --version

What gets installed?

The installation process provides two essential binaries:

  1. axiom: The primary interface. Used for init, build, pull, and interacting with the Axiom Hub.
  2. acore: The specialized language engine. It handles the evaluation of your .acore (PKL) configuration files.

Upgrading

Axiom Core is frequently updated with new features and runtime optimizations. To upgrade to the latest version:

Simply run the installation command again to overwrite the existing binaries with the latest version:

curl -fsSL https://axiomcore.dev/install | sh

Use the standard Homebrew upgrade command:

brew upgrade AxiomCore/tap/axiom

Next Steps

Now that you have the CLI, choose your path based on your role:

On this page