Hermes | AI Gateway - Orq.ai Documentation

Route every model call Hermes Agent makes through the Orq.ai AI Gateway. Requests appear in Traces automatically.

Prerequisites

Hermes installed (desktop app or CLI)
Active Orq.ai account with AI Gateway access
An AI Gateway API key

Setup

Hermes is OpenAI-compatible, so it routes through the AI Gateway by pointing the OpenAI provider at the router. Configure it in the desktop app or the CLI. Changes made in the desktop app apply to the CLI as well, since both share the same configuration.

Desktop app
CLI

Open provider settings

Open the Hermes desktop app. On first launch, skip provider selection to set it later. Open Settings in the top right, then go to Providers > API keys.

Set the OpenAI API key and base URL

Scroll to OpenAI API and expand it. Paste the AI Gateway API key into the OpenAI API key field and click Save. Then paste the router URL into the OpenAI API base URL override field and click Save:

https://api.orq.ai/v3/router

Hermes API keys settings with the OpenAI API entry expanded, the AI Gateway key in the OpenAI API key field, and the router URL in the base URL override field

Select a model

Hermes now routes through the AI Gateway. Pick a model from the recommended list, or search by name for any other model from the AI Gateway catalog that is not shown.

Open the config with hermes config edit and set the model block to a custom provider pointed at the router, with the AI Gateway key inline:

model:
  provider: custom
  default: "anthropic/claude-sonnet-4-6"
  base_url: "https://api.orq.ai/v3/router"
  api_key: "<your-orq-api-key>"

Replace <your-orq-api-key> with an API key.Set default to any provider-prefixed model from the AI Gateway catalog. Override the model for a single session with hermes chat --model openai/gpt-5.4.

The default config already contains a model block. Edit its existing keys; the block must end up with a single provider and a single base_url.

Verification

Send a prompt in Hermes. The response appears in Hermes and the request appears in Orq.ai Traces with the selected model identifier.

​Prerequisites

​Setup

​Verification

Prerequisites

Setup

Verification