All integrations
Autonomous agent (CLI, desktop, messaging)
How to Use Ruvicode with Hermes Agent
Hermes Agent supports named OpenAI-compatible providers in config.yaml. This guide adds Ruvicode as one, keeps the key in Hermes' .env file, and makes it the main model.
Tested on November 3, 2026. Hermes Agent 0.21.3 on Windows, with a fresh HERMES_HOME, read a file, edited it and replied through api.ruvicode.com using the config below.
Set up Hermes Agent
Base URL
https://api.ruvicode.com/v1
API key
rvcd_...
- 1Add RUVICODE_API_KEY=rvcd_... to ~/.hermes/.env. Secrets stay out of config.yaml.
- 2Add the providers.ruvicode block and the model block below to ~/.hermes/config.yaml.
- 3Start Hermes. Switch models in a session with /model, for example /model kimi-k2.7-code.
model:
provider: ruvicode
default: glm-5.3-flash
providers:
ruvicode:
api: https://api.ruvicode.com/v1
key_env: RUVICODE_API_KEYRUVICODE_API_KEY=rvcd_...Good to know
- key_env names the environment variable that holds the key. Hermes also accepts api_key: "${RUVICODE_API_KEY}" in the same place.
- Hermes reads the model list from GET /v1/models, so every Ruvicode model can be picked with /model without listing it.
- Auxiliary tasks such as compression, titles and vision use the main model by default, so they are billed to the same Ruvicode key.
Models for coding agents
These models completed streamed tool calls through Ruvicode on November 3, 2026. Every model in the catalog works with the same base URL and key; each model page shows its live rate, context window and max output.
- GLM 5.3 Flash
glm-5.3-flash - Claude Sonnet 5.5
claude-sonnet-5.5 - Kimi K2.7 Code
kimi-k2.7-code
Common errors
- 401 Invalid API key
- The key is mistyped, revoked or not a Ruvicode key. Copy it again from the dashboard; it starts with rvcd_.
- 404 Model not found
- The model id is not in the catalog. Use an id exactly as listed on the models page or by GET /v1/models. A plain 404 page instead of a JSON error means the base URL is missing /v1.
- 402 insufficient_balance
- The wallet cannot cover the request. Top up in the dashboard; the balance never expires.
- 429 rate limit
- Too many requests per minute, on the key or across the account. Agents that fire many calls in parallel can hit it; most tools retry on their own after a short wait.
Hermes Agent with Ruvicode: FAQ
- Do I need a different config for the Hermes desktop app or messaging gateway?
- No. The desktop app, the CLI and the messaging gateway read the same ~/.hermes/config.yaml and ~/.hermes/.env.
- Can I keep my old provider as a fallback?
- Yes. Keep its credentials and list it in Hermes' fallback_providers. Ruvicode stays the main provider.
- Where do I get a Ruvicode API key?
- Create an account, top up your wallet with QRIS or USDC, then open API Keys in the dashboard and create a key. Keys start with rvcd_. You can set a daily or monthly spend limit per key and restrict a key to a list of models.
Guides for other tools
The same base URL and key work everywhere. Setup for each tool: