Installation
Prerequisites
- Go 1.25+ — required for building from source
- Linux — Landlock sandboxing requires Linux kernel 5.13+. Will be disabled on unsupported platforms.
- At least one LLM provider running (Ollama, llama.cpp, OpenRouter, or OpenAI-compatible API key)
From Source
Install directly with Go:
go install github.com/idelchi/aura@latest
Or clone and build:
git clone https://github.com/idelchi/aura.git
cd aura
go build -o /tmp/aura-build/aura .
Docker
Build and run with Docker:
docker build -t aura .
docker run -it aura
Provider Setup
Aura requires at least one LLM provider. Configure providers in .aura/config/providers/.
Supported providers:
| Provider | Type | Default URL | URL Override |
|---|---|---|---|
| Ollama | Local | None (must be set in YAML) | Yes |
| llama.cpp | Local | None (must be set in YAML) | Yes |
| OpenRouter | Cloud | https://openrouter.ai/api/v1 | Yes |
| OpenAI | Cloud | https://api.openai.com/v1 | Yes |
| Anthropic | Cloud | https://api.anthropic.com | Yes |
| Google Gemini | Cloud | https://generativelanguage.googleapis.com/ | Yes |
| GitHub Copilot | Cloud | Dynamic (token exchange with GitHub) | No |
| OpenAI Plus (Codex) | Cloud | https://chatgpt.com/backend-api/codex | Yes |
Copilot does not accept URL overrides — its URL is resolved dynamically via GitHub’s token exchange API.
See Provider Configuration for YAML setup and token configuration.
Initialize Configuration
Scaffold the default configuration directory:
aura init
This creates .aura/config/ with all default agents, modes, providers, features, and prompts. See Configuration for details.
Environment Variables
All CLI flags can be set via AURA_ prefixed environment variables. Precedence: CLI flag > AURA_* env var > default value.
# Examples
export AURA_AGENT=high
export AURA_MODEL=llama3:8b
export AURA_DEBUG=1
# See all resolved settings
aura --print-env
Provider Tokens
| Variable | Description |
|---|---|
AURA_PROVIDERS_OLLAMA_TOKEN | Ollama API token (optional for local) |
AURA_PROVIDERS_LLAMACPP_TOKEN | llama.cpp API token (optional for local) |
AURA_PROVIDERS_OPENROUTER_TOKEN | OpenRouter API key (required) |
AURA_PROVIDERS_OPENAI_TOKEN | OpenAI API key (required) |
AURA_PROVIDERS_ANTHROPIC_TOKEN | Anthropic API key (required) |
AURA_PROVIDERS_GOOGLE_TOKEN | Google Gemini API key (required) |
AURA_PROVIDERS_COPILOT_TOKEN | GitHub OAuth token (via aura login copilot) |
AURA_PROVIDERS_CODEX_TOKEN | OpenAI refresh token (via aura login codex) |
Tokens can also be set in provider YAML configs or loaded from an env file via --env-file (default: secrets.env).