Integration · Nous Research

Run Hermes Agent on Crazyrouter

Hermes Agent uses an OpenAI-compatible endpoint. Point it at Crazyrouter and give it Claude, DeepSeek, Kimi or any other catalogue model without changing the agent.

One-command setup

Two scripts from the crazyrouter-hermes repo: a lightweight configurator for existing installs and a full installer that also brings up Hermes on a fresh Linux box.

macOS / Linux
curl -fsSL https://raw.githubusercontent.com/xujfcn/crazyrouter-hermes/main/setup.sh | bash
What the script does
  • setup.sh: Hermes is already installed — writes OPENAI_API_KEY, OPENAI_BASE_URL and the default model
  • setup-full.sh: fresh server — checks the OS, installs dependencies and Hermes first
  • Optionally sends a test request to confirm the key and endpoint

Scripts are fetched from the public GitHub repo linked below. Read them before piping to a shell if that's your policy; the download-then-run form is in the README.

Manual configuration

Environment

bash
export OPENAI_API_KEY=sk-your-crazyrouter-key
export OPENAI_BASE_URL=https://api.crazyrouter.com/v1
Base URL rule

https://api.crazyrouter.com/v1 — This tool is OpenAI-compatible and appends /chat/completions (or /responses) itself. Use the /v1 base URL exactly as shown.

Recommended models

Live Crazyrouter prices, refreshed hourly. Any model in the catalogue works; these are the ones we'd start with.

FAQ

Which base URL?

https://api.crazyrouter.com/v1 — Hermes is OpenAI-compatible, so the /v1 suffix is required.

Which model works best for long agent runs?

claude-sonnet-4-6 balances tool-use quality and cost; deepseek-v4-pro or kimi-k3 when you want a cheaper long-context option.

Can I run it on Windows?

The repo ships a setup.bat; Hermes itself is primarily tested on Linux and macOS.