Hermes

Ready-made agentsIntermediate4 min

Run Hermes Agent on Zukko models, billed from your balance.

You need: a fetch_... key (create one) and a balance from $1 (top up).

Leave the chat (Ctrl+C or /quit) and start the wizard:

bash

hermes model

Pick one of the two options. Codex CLI and Claude Code OAuth are subscriptions and don't work with Zukko.

1Option 1: Anthropic

yaml

model:
  provider: anthropic
  default: claude-sonnet-5
  base_url: https://api.zukko.pro

The key is in ~/.hermes/.env: ANTHROPIC_API_KEY=fetch_....

Works with any model, not just Claude.

bash

OPENAI_API_KEY=fetch_...
OPENAI_BASE_URL=https://api.zukko.pro/v1

Or in ~/.hermes/config.yaml:

yaml

model:
  provider: openai-api
  default: claude-sonnet-5
  base_url: https://api.zukko.pro/v1

Run hermes and type "Hi". Switch models in chat with /model.

What you see	What to do
401	Check the `fetch_...` key, no spaces
402	Top up
404 with Anthropic	Remove `/v1` from `base_url`
OpenAI option goes elsewhere	Address `https://api.zukko.pro/v1`, provider `openai-api`
404 `model_not_found` or 503 `model_disabled`	Pick a model from the list