Install

# One binary.
Sixty seconds.

Prebuilt binaries for Linux and macOS, x86_64 and aarch64. The install script verifies a SHA-256 checksum before installing anywhere on your PATH.

## Prebuilt binary

Recommended path. No Rust toolchain required.

curl -fsSL https://axocoatl.ai/install.sh | sh

## Cargo

If you'd rather compile. Requires Rust 1.82+.

cargo install axocoatl-cli

## From source

The release binary lands at `target/release/axocoatl`.

git clone https://github.com/axocoatl/axocoatl && cd axocoatl && cargo build --release

## After install

1. `axocoatl doctor` — verify Ollama, podman, and the data dir are reachable.
2. `axocoatl onboard` — interactive setup wizard. Picks a provider, scaffolds a project.
3. `axocoatl dev` — start the daemon, IPC, and dashboard on `:8080`.
4. Open `http://localhost:8080`. Switch to Sessions. Click the seeded demo-counters session.

Open the docs → Troubleshooting

## Bring your own LLM

Axocoatl runs against Ollama (local), OpenAI, Anthropic, Mistral, Gemini, and OpenRouter. Pick one in `onboard` or set it manually in `axocoatl.yaml`. Each agent picks its provider independently — local model for one, cloud for another, same workflow.

OpenRouter setup →