Skip to main content

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.

Auriko connects to Hermes Agent as a provider plugin, giving you access to 120+ models through a single API key.

​
Prerequisites

​
Install the plugin

Run the install script: 
curl -fsSL https://raw.githubusercontent.com/auriko-ai/auriko/main/integrations/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 Auriko repo into the plugin directory:
mkdir -p ~/.hermes/plugins/model-providers/auriko
cp __init__.py plugin.yaml ~/.hermes/plugins/model-providers/auriko/

​
Set your API key

export AURIKO_API_KEY="ak_live_..."
Add this line to ~/.zshrc or ~/.bashrc to persist it.

​
Configure Hermes

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

​
Verify

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
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
List all available models: 
curl -s -H "Authorization: Bearer $AURIKO_API_KEY" \
  https://api.auriko.ai/v1/models | jq '.data[].id'
Hermes discovers models dynamically from /v1/models. You don’t need to maintain a static list.

​
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/
Then run hermes model to select a different provider.

​
Troubleshooting

SymptomCauseFix
401 / Missing AuthenticationAURIKO_API_KEY not set or wrongAdd export AURIKO_API_KEY="ak_live_..." to your shell profile, then source ~/.zshrc
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
Timeout fetching modelsAPI unreachableCheck your connection. Hermes falls back to a built-in model list.