Hermes Agent - Auriko

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

Auriko is a plugin provider, not built-in.

Prerequisites

Hermes Agent 0.14.0+
An Auriko API key

Install Hermes Agent

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

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:

hermes --version

You need version 0.14.0 or later.

Install the plugin

Run the install script:

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/.

Install files manually

Download both files from the integrations repo into the plugin directory:

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

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:

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.

Configure with the model wizard

If you have an interactive terminal:

hermes model

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

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

Verify

Run a quick test to confirm the connection:

hermes chat -q "Say exactly: setup-ok" -Q --model claude-haiku-4-5-20251001

Use different models

Pass any Auriko model ID:

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:

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. See routing options for details.

Uninstall

Remove the plugin directory:

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.

​Prerequisites

​Install Hermes Agent

​Install the plugin

​Set your API key

​Configure Hermes

​Verify

​Use different models

​Control routing

​Uninstall

​Troubleshoot

Prerequisites

Install Hermes Agent

Install the plugin

Set your API key

Configure Hermes

Verify

Use different models

Control routing

Uninstall

Troubleshoot