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

# Hermes Agent

> Use Auriko as your LLM provider in Hermes Agent

Auriko connects to Hermes Agent as a provider plugin. You access multiple models through a single API key.

<Note>
  Auriko is a plugin provider, not built-in.
</Note>

## Prerequisites

* [Hermes Agent](https://hermes-agent.nousresearch.com) 0.14.0+
* An [Auriko API key](https://auriko.ai/signup?redirectTo=%2Fdashboard%3Ftab%3Dapi-keys)

## Install Hermes Agent

Hermes Agent requires Python 3.11+. Run the official installer:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```

This installs to `~/.hermes/` with an isolated Python venv and adds `hermes` to your PATH.

Open a new terminal, then confirm the installation:

```bash theme={null}
hermes --version
```

You need version 0.14.0 or later.

## Install the plugin

Run the install script:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/auriko-ai/integrations/main/hermes-agent/install.sh | bash
```

This copies two files (`__init__.py` and `plugin.yaml`) to `~/.hermes/plugins/model-providers/auriko/`.

<Accordion title="Install files manually">
  Download both files from the [integrations repo](https://github.com/auriko-ai/integrations/tree/main/hermes-agent/plugin) into the plugin directory:

  ```bash theme={null}
  mkdir -p ~/.hermes/plugins/model-providers/auriko
  curl -fsSL https://raw.githubusercontent.com/auriko-ai/integrations/main/hermes-agent/plugin/__init__.py \
    -o ~/.hermes/plugins/model-providers/auriko/__init__.py
  curl -fsSL https://raw.githubusercontent.com/auriko-ai/integrations/main/hermes-agent/plugin/plugin.yaml \
    -o ~/.hermes/plugins/model-providers/auriko/plugin.yaml
  ```
</Accordion>

## Set your API key

The plugin install script adds an empty placeholder to `~/.hermes/.env`. Open the file and set your key:

```
AURIKO_API_KEY=ak_live_...
```

Your key starts with `ak_live_` (production) or `ak_test_` (testing).

Hermes also reads `AURIKO_API_KEY` from your shell environment (`~/.zshrc` or `~/.bashrc`).

## Configure Hermes

Set Auriko as the default provider:

```bash theme={null}
hermes config set model.provider auriko
hermes config set model.default claude-haiku-4-5-20251001
hermes config set model.base_url https://api.auriko.ai/v1
hermes config set providers.auriko.base_url https://api.auriko.ai/v1
hermes config set providers.auriko.key_env AURIKO_API_KEY
```

Use `auriko` as the provider value, not `custom`.

<Accordion title="Configure with the model wizard">
  If you have an interactive terminal:

  ```bash theme={null}
  hermes model
  ```

  Select **Auriko** from the provider list, confirm your API key, and pick a default model.

  <Note>
    With Hermes 0.14.x, the model list may be empty for plugin providers. Use the config commands above instead.
  </Note>
</Accordion>

## Verify

Run a quick test to confirm the connection:

```bash theme={null}
hermes chat -q "Say exactly: setup-ok" -Q --model claude-haiku-4-5-20251001
```

## Use different models

Pass any Auriko model ID:

```bash theme={null}
hermes chat --model deepseek-v3.2
hermes chat --model gemini-2.5-flash
hermes chat --model claude-opus-4-7
```

These are some of the models available through Auriko:

| Model                    | Author    | Context |
| ------------------------ | --------- | ------- |
| `claude-sonnet-4-6`      | Anthropic | 1M      |
| `claude-opus-4-6`        | Anthropic | 1M      |
| `claude-opus-4-7`        | Anthropic | 1M      |
| `deepseek-v4-flash`      | DeepSeek  | 1M      |
| `deepseek-v4-pro`        | DeepSeek  | 1M      |
| `gemini-2.5-flash`       | Google    | 1M      |
| `gemini-2.5-pro`         | Google    | 1M      |
| `gemini-3.1-pro-preview` | Google    | 1M      |
| `glm-5.1`                | Z.AI      | 200K    |
| `grok-4.3`               | xAI       | 1M      |
| `kimi-k2.5`              | Moonshot  | 262K    |
| `minimax-m2-7`           | MiniMax   | 205K    |
| `minimax-m2-7-highspeed` | MiniMax   | 205K    |
| `qwen-3.6-plus`          | Alibaba   | 1M      |

To list available models:

```bash theme={null}
curl -s -H "Authorization: Bearer $AURIKO_API_KEY" \
  https://api.auriko.ai/v1/models | jq '.data[].id'
```

Auriko model IDs use bare names with hyphens:

| Wrong (404)                 | Correct             |
| --------------------------- | ------------------- |
| `anthropic/claude-opus-4.6` | `claude-opus-4-6`   |
| `openai/gpt-4o`             | `gpt-4o-2024-11-20` |
| `deepseek/deepseek-chat`    | `deepseek-v3.2`     |

Hermes reads available models from `/v1/models`.

## Control routing

Configure routing in the [Auriko dashboard](https://auriko.ai/dashboard). See [routing options](/guides/routing-options) for details.

## Uninstall

Remove the plugin directory:

```bash theme={null}
rm -rf ~/.hermes/plugins/model-providers/auriko/
```

Open `~/.hermes/config.yaml` and remove the `auriko` block under `providers:`. You can also run `hermes config edit` to open the file in your editor.

Then run `hermes model` to select a different provider.

If you no longer need the API key, remove `AURIKO_API_KEY` from `~/.hermes/.env` and your shell profile.

## Troubleshoot

| Symptom                                    | Cause                                                               | Fix                                                                                                                                                                                              |
| ------------------------------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 401 / Missing Authentication               | `AURIKO_API_KEY` not set or wrong                                   | Add your key to `~/.hermes/.env` or export it in your shell profile                                                                                                                              |
| Requests go to wrong provider              | Stale `model.base_url` from a previous provider                     | Run `hermes config set model.base_url https://api.auriko.ai/v1`                                                                                                                                  |
| Auriko not in `hermes model` list          | Plugin not installed or wrong path                                  | Re-run the install script. Verify `~/.hermes/plugins/model-providers/auriko/__init__.py` exists.                                                                                                 |
| Model not found (404)                      | Wrong model ID format                                               | Use bare Auriko IDs (`claude-opus-4-6`, not `anthropic/claude-opus-4.6`)                                                                                                                         |
| `No auxiliary LLM provider configured`     | Hermes auxiliary model not set                                      | Safe to ignore                                                                                                                                                                                   |
| `Unknown provider 'auriko'`                | Provider not registered in `config.yaml`                            | Re-run the install script. If you installed manually, run `hermes config set providers.auriko.base_url https://api.auriko.ai/v1` and `hermes config set providers.auriko.key_env AURIKO_API_KEY` |
| Timeout fetching models                    | API unreachable                                                     | Check your connection. Hermes falls back to a built-in model list.                                                                                                                               |
| Model picker shows 0 Auriko models         | Model list not populated for plugin providers                       | Use `hermes config set model.default <model-id>` to set a model directly                                                                                                                         |
| qwen-3.6-plus compresses context too early | Context length not detected correctly for some large-context models | Run `hermes config set model.context_length 1000000`. Remove this override when switching to a different model.                                                                                  |