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:
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 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:
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
Or make it the profile's default in its config.yaml:
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.
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
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
Switch models any time:
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.