Skip to main content
Hermes Agent is Nous Research’s terminal AI assistant with a unified TUI interface. Connect it to ClearMaas via its YAML config file or environment variables to access OpenAI and Anthropic models through a single endpoint.

​
Prerequisites

  • Hermes Agent installed (pip install hermes-agent or via installer)
  • A ClearMaas API key starting with sk-

​
Config file locations

All settings live in ~/.hermes/:

​
Setup via config.yaml

Add to ~/.hermes/config.yaml:
Then add your API key to ~/.hermes/.env:

​
Provider options

The provider field accepts these values: Setting provider: "custom" with a base_url routes all requests through ClearMaas.

​
Using the Anthropic protocol

For native Anthropic requests (bypassing translation), use the bare host URL:
The key difference: ClearMaas’s Anthropic path (https://api.clearmaas.com) expects the SDK to append /v1/messages, while the OpenAI-compatible path (https://api.clearmaas.com/v1) is the complete endpoint.

​
Interactive setup

If you prefer a guided setup:
This interactive command walks through provider selection. Choose custom and enter:
  • Base URL: https://api.clearmaas.com/v1 (OpenAI-compatible) or https://api.clearmaas.com (Anthropic-compatible)
  • API Key: sk-...

​
Environment variable override

Override settings at runtime:
Environment variables take highest precedence, followed by CLI arguments, config.yaml, then .env.

​
Choosing models

Set the default model in config.yaml:
Use any ClearMaas model prefix:

​
Config migration

After updating Hermes Agent, migrate your config to include new options:

​
Verification

Check your ClearMaas dashboard to confirm requests are routed.

​
See also