Skip to main content
kRouter
All integrations

Use Hermes Agent with any AI provider

Nous Research self-improving AI agent. Pointing Hermes Agent at kRouter gives it 100+ providers behind a single local endpoint — free tiers, subscriptions you already pay for, and paid APIs — with automatic failover when one runs out. Hermes Agent is configured through a config file.

Setup

  1. Install kRouter

    Install globally, then start it in the background.

  2. Connect a provider

    Open the dashboard and connect whichever providers you want Hermes Agent to reach.

  3. Point Hermes Agent at kRouter

    Set the base URL to http://localhost:20128/v1 and paste a kRouter API key.

What changes for Hermes Agent

Nothing about how you use Hermes Agent changes — same interface, same workflow. What changes is where its requests land. Instead of being tied to one vendor and one bill, every request goes through your own machine first and out to whichever provider you mapped: a free tier for routine edits, a subscription you already pay for on the heavy turns, a paid API only when nothing else fits. When one account hits a limit, the next takes over mid-session rather than failing the task. And because the router runs locally, your prompts are not passing through a third-party service on the way.

Troubleshooting Hermes Agent

The config file change has no effect

Confirm you edited the file the tool actually reads — some tools keep separate global and project configs, and the project one wins. Restart the tool after editing.

Model not found after switching

Model ids are provider-prefixed here (provider/model). Call GET /v1/models against kRouter to see the exact ids your connected providers expose.

Hermes Agent + kRouter FAQ

Can Hermes Agent use providers other than its default?

Yes — that is the point of routing it through kRouter. kRouter presents one OpenAI-compatible endpoint that fans out to 100+ providers, so Hermes Agent can reach any of them without knowing they exist.

How is Hermes Agent pointed at kRouter?

Through a config file. Nothing about Hermes Agent itself changes — it still speaks the same API.

Does routing Hermes Agent through kRouter cost anything?

kRouter is free and MIT-licensed and adds nothing to your bill. What you pay is whatever the provider you routed to charges — which is often nothing, if you route to a free tier or a subscription you already hold.

What happens when a provider runs out of quota mid-session?

kRouter parks that account until its real reset time and fails over to the next one you have connected, so Hermes Agent keeps working instead of erroring out mid-task.

Get Hermes Agent routing in two minutes

kRouter is free, MIT-licensed, and runs entirely on your machine — no account, no proxy in the middle.

Install kRouter