Integrations

Hermes

Run Claude in Hermes with Roteo's plugin, or open-weight and GPT models through its custom provider.

Hermes is an agent framework from Nous Research. It reaches Roteo two ways:

You wantUseModels
ClaudeRoteo's Hermes plugin, which runs Claude Code underneathopus, sonnet, haiku, fable
Open-weight or GPTHermes' built-in custom providergpt-5.6-sol, glm-5.3 and more

Claude models

The roteo-claude plugin drives the official Claude Code CLI as Hermes' model client. Hermes keeps its own agent loop, tools, approvals and compaction; Claude Code sends each request to Roteo with your key. No Claude login is needed.

1. Requirements

  • Hermes 0.22 or newer. On an older Hermes the plugin does not load: run hermes update.
  • Claude Code, installed but not logged in: see Claude Code.

2. Install the plugin

hermes plugins install roteo-ai/hermes-plugin-roteo
hermes plugins enable roteo-claude
bash · 2 lines

Hermes notes that this is a "custom (unreviewed) source, not from the Hermes catalog". That is expected: the plugin installs from Roteo's repository.

3. Add your key

Put your key in the .env of the Hermes profile you use:

Profile.env location
default, Windows%LOCALAPPDATA%\hermes\.env
default, macOS / Linux~/.hermes/.env
a named profile<hermes home>/profiles/<name>/.env
ROTEO_API_KEY=sk_your_key

That is the only setting. The plugin keeps Claude Code's telemetry off and gives it its own config folder per profile, apart from any Claude login of yours.

4. Run

hermes --provider roteo-claude -m opus
bash · 1 lines

Or make it the profile's default in its config.yaml:

model:
  provider: roteo-claude
  default: sonnet
yaml · 3 lines

If Hermes' setup wizard asked you for a provider and you entered Roteo as a custom endpoint with a Claude model, that is the custom provider, where Claude is refused. Run with --provider roteo-claude as above, or change those two lines in config.yaml.

Short nameRuns
opusClaude Opus 5.5
sonnetClaude Sonnet 5.5
haikuClaude Haiku 5.5
fableClaude Fable 5.2

All four are supported, Fable 5.2 included. As everywhere else, Fable's own safeguards turn down cybersecurity-related requests, so use another model for those. Every request is billed to your Roteo balance. Hermes shows the cost as n/a: each request's charge is in your dashboard. Long sessions are cheap after the first turn, because Hermes' large prompt is read from cache on every step.

If it fails

You seeDo this
"No Roteo API key for this Hermes profile"Add ROTEO_API_KEY to that profile's .env
"Roteo did not accept the API key"The key is wrong or revoked. Check it in your dashboard
"Billing or credits exhausted ... Insufficient balance"Top up your balance in the dashboard
Hermes says the provider "rejected your sign-in" and suggests auth add ... --type oauthThat is Hermes' general wording. The line under it, Provider said: ..., has the real reason
"Fable 5.2's safeguards flagged this message"Fable turns down cybersecurity-related requests, in every tool. Use -m opus or -m sonnet for that task
"Third-party agent frameworks aren't supported on Claude models"Hermes is on its custom provider (often set by its setup wizard). Run with --provider roteo-claude
"Gateway inaccessible: gateway_elevated"Hermes' background gateway was started as administrator, often by the installer. Open PowerShell as administrator, run hermes gateway stop, then start Hermes from a normal window
"Claude Code is not installed"Install it (see Claude Code)
A plugin update has no effectHermes runs one background gateway for all profiles: run hermes gateway stop, and the next request starts a fresh one

The plugin's settings and source are in its README.

Open-weight and GPT models

Hermes also speaks the Chat Completions wire through a built-in custom provider, so it connects to Roteo with four settings and no proxy.

Connect

hermes config set model.provider custom
hermes config set model.base_url https://api.roteo.ai/v1
hermes config set model.api_key sk_your_key
hermes config set model.default gpt-5.6-sol
hermes
bash · 5 lines

Switch models any time:

hermes config set model.default gpt-6-astra
bash · 1 lines

Models

Use an open-weight or gpt-* id from Models. Claude ids are refused on the custom provider; for Claude, use the plugin above.

If it fails

Check three things: the key is a Roteo sk_ key, the base URL ends in /v1, and the model is not a Claude id.

Hermes | Roteo