Hermes Agent Integration

Overview

Hermes Agent by Nous Research is a self-improving AI agent that runs as a CLI, TUI, messaging gateway, or IDE integration with on-disk memory. Set its provider to custom and point the base URL at UnoRouter to serve every model from one endpoint.

Quick Config

Paste these into the client. Your key auto-fills when signed in.

Base URL: https://api.unorouter.com/v1
API Key: YOUR_API_KEY

Compatibility

Step-by-step setup

1. 1
   Install Hermes

   Run the install script. On Windows, install inside WSL2.

   bash

   curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

   Sign in to auto-fill your API key

2. 2
   Point the provider at UnoRouter

   In `~/.hermes/config.yaml`, set `model.provider` to `custom` and `model.base_url` to UnoRouter's base URL. Pick a default model with at least 64k context.

   yaml

   # ~/.hermes/config.yaml
   model:
     provider: "custom"
     base_url: "https://api.unorouter.com/v1"
     default: "YOUR_MODEL_ID"

   Sign in to auto-fill your API key

3. 3
   Add your API key

   Store your UnoRouter API key as `OPENAI_API_KEY` in `~/.hermes/.env`.

   bash

   # ~/.hermes/.env
   OPENAI_API_KEY=YOUR_API_KEY

   Sign in to auto-fill your API key

4. 4
   Run Hermes

   Start the TUI with `hermes --tui`.

   bash

   hermes --tui

   Sign in to auto-fill your API key

# Hermes runs under WSL2 on Windows.
# In ~/.hermes/config.yaml set model.provider: "custom"
# and model.base_url: "https://api.unorouter.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

hermes --tui

Recommended models

Free models that work here. Paste any model id into the client.

Gotchas

• !Hermes rejects models under 64,000 tokens of context at startup. Pick a larger-context model from UnoRouter's models page.
• !If the startup `/v1/models` check fails, confirm `model.base_url` ends in `/v1` and `OPENAI_API_KEY` is set in `~/.hermes/.env`.