opendunes
Coding agents
Copy page ▾

Hermes Agent

Run Hermes Agent, Nous Research's terminal agent, on models you pay for in DADAThe Algerian dinar, the one currency the docs show.More on Balance and charges →.

Hermes takes named providers in ~/.hermes/config.yaml. OpenDunes goes in as one of them, and Hermes sends each request to POST /v1/chat/completions.

  1. Install Hermes Agent.
  2. Add OpenDunes as a provider.
  3. Check the setup.
  4. Switch models in a chat.

1. Install Hermes Agent

OnInstall line
macOS, Linux, WSLcurl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows, PowerShelliex (irm https://hermes-agent.nousresearch.com/install.ps1)

Create an API keyAPI keyThe key you create and send with every request that calls a model.More on API keys → for Hermes alone, and cap it on API Keys (API keys shows how). Put it in your shell profile, ~/.zshrc or ~/.bashrc, as export OPENDUNES_API_KEY="…".

2. Add OpenDunes as a provider

Open the file with hermes config edit, and add:

Yaml
providers:
  opendunes:
    api: https://opendunes.com/v1
    key_env: OPENDUNES_API_KEY
    transport: chat_completions

model:
  default: anthropic/claude-sonnet-4.5
  provider: custom:opendunes
KeyHolds
providers.opendunes.apithe address, with /v1
providers.opendunes.key_envthe variable Hermes reads the key from: the key stays out of the file
providers.opendunes.transportchat_completions, the shape Hermes sends
model.defaultthe model IDModel IDThe name a request calls a model by, lab/model, copied from Models.More on Models → Hermes starts on, from Models
model.providercustom:opendunes: the provider above

3. Check the setup

Shell
hermes doctor
hermes -z "Name this project's main language in one word."

hermes doctor reads the file and names any setting it cannot use. hermes -z sends one task and prints the answer. Then open Activity, in the app on opendunes.com: the request is there, with its charge in DA.

Start a chat with hermes.

4. Switch models in a chat

/model takes the provider and a model ID, joined by colons:

Text
/model custom:opendunes:anthropic/claude-opus-5.5

The chat goes on with that model, on the same key. Each model is charged at its own rate, shown on its page in Models.

Watch out

Hermes runs a task in many requests, and each one reads the conversation so far. Watch Activity during your first long task, and set the key's cap to what one day of work may spend.

Errors

StatusMeansDo
401the key is missing, wrong, paused, revoked or expiredcheck OPENDUNES_API_KEY in the terminal Hermes starts from
402the balanceBalanceWhat you can spend, in DA.More on Balance and charges → is at zero or below, cannot pay the request's hold, or the key's cap is spentmake a depositDepositMoney entering your balance, by CIB or Edahabia card.More on Balance and charges →, or raise the cap
404the model ID is not on salecopy the ID from Models

Every other status: Errors and retries. Other terminal agents: Coding agents.

Next: OpenClaw · Junie CLI

Last modified on