Installation

Get ayo running on your machine in a few minutes.

Requirements

The simplest way to install ayo:

go install github.com/ayo-ooo/ayo/cmd/ayo@latest

This installs the ayo binary to your $GOPATH/bin directory. Make sure this directory is in your PATH.

ayo needs access to an LLM provider. Set your API key as an environment variable:

export ANTHROPIC_API_KEY="sk-ant-..."

export OPENAI_API_KEY="sk-..."

export OPENROUTER_API_KEY="sk-or-..."

Add this to your shell configuration (~/.bashrc, ~/.zshrc, etc.) to persist it.

Initialize ayo with the setup wizard:

ayo setup

This creates the necessary directories, verifies your API key, and configures default settings.

Check that everything is working:

ayo doctor

This command checks:

You're ready to go. Start an interactive session:

ayo

Or send a single prompt:

ayo "What can you help me with?"

Make sure $GOPATH/bin is in your PATH. Add this to your shell config:

export PATH="$PATH:$(go env GOPATH)/bin"

Verify your API key is set correctly:

echo $ANTHROPIC_API_KEY

If empty, set it again and source your shell config.

If you see permission errors during setup, ensure you have write access to ~/.config/ayo and ~/.local/share/ayo.

Now that ayo is installed, create your first agent.