Hermes Agent Integration

1. Prerequisites

Registered and obtained a platform API Key.
Hermes Agent installed.

2. Recommended: One-Command Setup with codesw

codesw writes directly to ~/.hermes/config.yaml and ~/.hermes/.env (mode 0600), setting up the provider, base URL, default model and OpenAI key — no proxy, no middleman.

2.1 Install

bash

npm i -g @bumocc/codesw
# or
yarn global add @bumocc/codesw

2.2 Run the interactive mode

Just execute:

bash

codesw

Follow the prompts — use the arrow keys to select and Enter to confirm. Three steps:

Which client to configure: choose Hermes Agent.
Which provider: choose Bumo Router. The first time, paste the key from the API Keys page (shown as * while typing); it is saved and reused afterwards.
Which model: recommended models are listed first, e.g. claude-sonnet-5-5; or choose "Enter a model ID…" to type your own.

codesw writes the following into ~/.hermes/config.yaml:

model.provider: custom
model.base_url: https://router.bumo.ai/v1
model.default: <your chosen model>
model_aliases.codesw-<model>: one alias per available model, for quick switching inside Hermes.

It also writes OPENAI_API_KEY=<your key> into ~/.hermes/.env.

Once it finishes, start Hermes Agent as usual. To switch models or providers later, just run codesw again — no need to re-enter the key.

Appendix: Manual Configuration (Alternative)

Edit ~/.hermes/config.yaml and merge:

yaml

model:
  provider: custom
  base_url: https://router.bumo.ai/v1
  default: claude-sonnet-4-6

model_aliases:
  bumo-claude-sonnet-4-6:
    model: claude-sonnet-4-6
    provider: custom
    base_url: https://router.bumo.ai/v1

Set the API key in ~/.hermes/.env (recommended mode 0600):

env

OPENAI_API_KEY=YOUR_API_KEY

Replace YOUR_API_KEY with your platform API Key.

Hermes Agent Integration ​

1. Prerequisites ​

2. Recommended: One-Command Setup with codesw ​

2.1 Install ​