Hermes Agent

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

Arbytra is a plugin provider, not built-in.

Prerequisites

Hermes Agent 0.14.0+
An Arbytra 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/arbytra-ai/integrations/main/hermes-agent/install.sh | bash

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

Install files manually

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

mkdir -p ~/.hermes/plugins/model-providers/arbytra
curl -fsSL https://raw.githubusercontent.com/arbytra-ai/integrations/main/hermes-agent/plugin/__init__.py \
  -o ~/.hermes/plugins/model-providers/arbytra/__init__.py
curl -fsSL https://raw.githubusercontent.com/arbytra-ai/integrations/main/hermes-agent/plugin/plugin.yaml \
  -o ~/.hermes/plugins/model-providers/arbytra/plugin.yaml

Set your API key

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

ARBYTRA_API_KEY=ak_live_...

Your key starts with ak_live_ (production) or ak_test_ (testing). Hermes also reads ARBYTRA_API_KEY from your shell environment (~/.zshrc or ~/.bashrc).

Configure Hermes

Set Arbytra as the default provider:

hermes config set model.provider arbytra
hermes config set model.default claude-haiku-4-5-20251001
hermes config set model.base_url https://api.arbytra.com/v1
hermes config set providers.arbytra.base_url https://api.arbytra.com/v1
hermes config set providers.arbytra.key_env ARBYTRA_API_KEY

Use arbytra as the provider value, not custom.

Configure with the model wizard

If you have an interactive terminal:

hermes model

Select Arbytra 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 Arbytra 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 Arbytra:

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 $ARBYTRA_API_KEY" \
  https://api.arbytra.com/v1/models | jq '.data[].id'

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

Uninstall

Remove the plugin directory:

rm -rf ~/.hermes/plugins/model-providers/arbytra/

Open ~/.hermes/config.yaml and remove the arbytra 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 ARBYTRA_API_KEY from ~/.hermes/.env and your shell profile.

Troubleshoot

Symptom	Cause	Fix
401 / Missing Authentication	`ARBYTRA_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.arbytra.com/v1`
Arbytra not in `hermes model` list	Plugin not installed or wrong path	Re-run the install script. Verify `~/.hermes/plugins/model-providers/arbytra/__init__.py` exists.
Model not found (404)	Wrong model ID format	Use bare Arbytra 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 'arbytra'`	Provider not registered in `config.yaml`	Re-run the install script. If you installed manually, run `hermes config set providers.arbytra.base_url https://api.arbytra.com/v1` and `hermes config set providers.arbytra.key_env ARBYTRA_API_KEY`
Timeout fetching models	API unreachable	Check your connection. Hermes falls back to a built-in model list.
Model picker shows 0 Arbytra 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.

Get Started

Guides

Response API

Frameworks

Integrations

Specifications

Platform

Changelog

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

Prerequisites

Install Hermes Agent

Install the plugin

Set your API key

Configure Hermes

Verify

Use different models

Control routing

Uninstall

Troubleshoot