Install

One binary.
Sixty seconds.

Prebuilt binaries for Linux and macOS, x86_64 and aarch64 — and on Windows, inside WSL2. 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

Windows (WSL2)

Axocoatl is Unix-first — the session sandbox is Podman, the service is systemd/launchd — so on Windows it runs inside WSL2, not natively. Set up WSL2 (wsl --install in an admin PowerShell), then inside your distro install Podman and run the same one-liner:

sudo apt-get install -y podman && curl -fsSL https://axocoatl.ai/install.sh | sh

Run axocoatl dev in WSL, then open http://localhost:8080 in your Windows browser. Full steps in the Windows guide.

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 →