> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mezmo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Example Configs

> Example TOML configurations and advanced quickstarts for AURA agents.

Example TOML configurations and advanced quickstarts for AURA agents.

<Note>**New to AURA?** Start with the [Quickstart](/aura/quickstart). It installs AURA, generates a config, and connects it to your tools. Come back here when you're ready to customize.</Note>

## Reference Configuration

[`reference.toml`](https://github.com/mezmo/aura/blob/main/examples/reference.toml) is the fully annotated config with every option documented. Use it as a starting point:

```bash theme={null}
cp examples/reference.toml config.toml
# Edit config.toml with your API key and settings
cargo run --bin aura -- webserver
```

If encountering issues and more verbose debugging output is necessary, add the --verbose flag for the running binary

```bash theme={null}
export OPENAI_API_KEY="sk-..."
CONFIG_PATH=examples/minimal/openai.toml cargo run --bin aura -- webserver --verbose
```

## Minimal Configs

Bare-minimum configs to get running with a single LLM provider. No MCP tools: just add an API key.

```bash theme={null}
export OPENAI_API_KEY="sk-..."
CONFIG_PATH=examples/minimal/openai.toml cargo run --bin aura -- webserver
```

| File | Provider | API key needed? |
| - | - | - |
| [`openai.toml`](https://github.com/mezmo/aura/blob/main/examples/minimal/openai.toml) | OpenAI | Yes |
| [`anthropic.toml`](https://github.com/mezmo/aura/blob/main/examples/minimal/anthropic.toml) | Anthropic | Yes |
| [`bedrock.toml`](https://github.com/mezmo/aura/blob/main/examples/minimal/bedrock.toml) | AWS Bedrock | AWS credentials |
| [`gemini.toml`](https://github.com/mezmo/aura/blob/main/examples/minimal/gemini.toml) | Google Gemini | Yes |
| [`ollama.toml`](https://github.com/mezmo/aura/blob/main/examples/minimal/ollama.toml) | Ollama (local) | No |

## Complete Agent Configs

Full agent compositions that combine an LLM provider with real MCP tool servers and tailored system prompts. Each file documents its prerequisites and required environment variables.

The system prompts in `incident-response-mezmo.toml`, `incident-response-datadog.toml`, and `kubernetes-sre.toml` tell the agent to query the last 5 minutes of telemetry by default. To look further back, name the window in your request, for example "check error rates over the past 2 hours." To change the default, edit the 5-minute instruction in the config's `system_prompt`.

| File | Description |
| - | - |
| [`devops-assistant.toml`](https://github.com/mezmo/aura/blob/main/examples/complete/devops-assistant.toml) | GitHub MCP |
| [`incident-response-mezmo.toml`](https://github.com/mezmo/aura/blob/main/examples/complete/incident-response-mezmo.toml) | PagerDuty + Mezmo |
| [`incident-response-datadog.toml`](https://github.com/mezmo/aura/blob/main/examples/complete/incident-response-datadog.toml) | PagerDuty + Datadog |
| [`incident-response-checkly.toml`](https://github.com/mezmo/aura/blob/main/examples/complete/incident-response-checkly.toml) | Checkly |
| [`kubernetes-sre.toml`](https://github.com/mezmo/aura/blob/main/examples/complete/kubernetes-sre.toml) | K8s MCP + Prometheus |

### Serving Multiple Agents

Point `CONFIG_PATH` at a directory to serve every `.toml` file as a selectable agent:

```bash theme={null}
CONFIG_PATH=examples/complete/ cargo run --bin aura -- webserver
```

Clients discover agents via `GET /v1/models` and select one with the `model` field in chat requests. Each agent is identified by its `alias` (if set) or `name`.

## Advanced Quickstarts

Self-contained Docker Compose setups for specific use cases. Each has its own guide with step-by-step instructions.

| Quickstart | Description |
| - | - |
| [Kubernetes SRE](/aura/quickstart-k8s-sre) | AI-powered SRE agent on KIND with Kubernetes and Prometheus MCP servers |