Skip to content

Hermes Agent

Hermes Agent supports custom OpenAI-compatible endpoints.

Set it up

Run hermes setup, choose Custom OpenAI-compatible endpoint, and enter:

SettingValue
Base URLhttps://api.cloakray.com/v1
API keyYour Cloakray key
ModelA model ID from the catalogue, such as deepseek-v4-flash

Or write the files yourself. In ~/.hermes/config.yaml:

model:
  provider: custom
  default: deepseek-v4-flash
  base_url: https://api.cloakray.com/v1

And the credentials in ~/.hermes/.env:

OPENAI_API_KEY=ckr_...
OPENAI_BASE_URL=https://api.cloakray.com/v1

Keep the .env file private.

Use it

cd your-project
hermes chat

For a single task that exits when done:

hermes chat --oneshot -q "Fix the failing test and run it again"

--model switches the model for a session.