Skip to main content
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

​
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/.
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.
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:
ModelAuthorContext
claude-sonnet-4-6Anthropic1M
claude-opus-4-6Anthropic1M
claude-opus-4-7Anthropic1M
deepseek-v4-flashDeepSeek1M
deepseek-v4-proDeepSeek1M
gemini-2.5-flashGoogle1M
gemini-2.5-proGoogle1M
gemini-3.1-pro-previewGoogle1M
glm-5.1Z.AI200K
grok-4.3xAI1M
kimi-k2.5Moonshot262K
minimax-m2-7MiniMax205K
minimax-m2-7-highspeedMiniMax205K
qwen-3.6-plusAlibaba1M
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.6claude-opus-4-6
openai/gpt-4ogpt-4o-2024-11-20
deepseek/deepseek-chatdeepseek-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

SymptomCauseFix
401 / Missing AuthenticationAURIKO_API_KEY not set or wrongAdd your key to ~/.hermes/.env or export it in your shell profile
Requests go to wrong providerStale model.base_url from a previous providerRun hermes config set model.base_url https://api.auriko.ai/v1
Auriko not in hermes model listPlugin not installed or wrong pathRe-run the install script. Verify ~/.hermes/plugins/model-providers/auriko/__init__.py exists.
Model not found (404)Wrong model ID formatUse bare Auriko IDs (claude-opus-4-6, not anthropic/claude-opus-4.6)
No auxiliary LLM provider configuredHermes auxiliary model not setSafe to ignore
Unknown provider 'auriko'Provider not registered in config.yamlRe-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 modelsAPI unreachableCheck your connection. Hermes falls back to a built-in model list.
Model picker shows 0 Auriko modelsModel list not populated for plugin providersUse hermes config set model.default <model-id> to set a model directly
qwen-3.6-plus compresses context too earlyContext length not detected correctly for some large-context modelsRun hermes config set model.context_length 1000000. Remove this override when switching to a different model.