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 →