How to get Hermes
An assistant that runs on your own machine, takes a job and carries it through. Installing takes minutes, and it isn't for sale.
Hermes is an agent. The difference from the chat is that it doesn't just talk: it runs on your computer, can run commands, read files and push a job forward step by step until it's done.
First, two things people always ask. You don't buy Hermes from us: it's a free open-source tool made by other developers, not an IranRouter product. What costs money is the model Hermes uses, and that comes off your wallet.
So you need three things: Hermes itself, an ir- key, and some balance.
Before installing
Hermes installs on Linux, macOS, WSL2 and Windows. A Desktop version for macOS and Windows is on its own site. The model you pick must have at least 64K tokens of context; that figure is on each model's page.
Step one: make a key
A key for Hermes0 of 5 steps
- Go to API keys and press New key.
- Name it "Hermes laptop".
- Set "Where should this key's spend come from?" to Credit (pay as you go).
- Set a Monthly cap. A small number is fine to begin.
- Copy the key and tick "I've stored the key somewhere safe". It's shown only this once.
Step two: install Hermes
On Linux, macOS or WSL2, open a terminal and run:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash source ~/.bashrc # or ~/.zshrc
On Windows, in PowerShell:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Step three: connect it to IranRouter
Open ~/.hermes/config.yaml and write the model section like this. Replace ir-... with your key, and take the model id from the models page:
model:
provider: custom
default: anthropic/claude-sonnet-4.6
base_url: https://iranrouter.com/v1
api_key: ir-...If you'd rather not edit the file, run hermes model, choose the custom endpoint option, and give the same address and key.
Step four: try it
hermes --tui
Write "Hello, what files are in this folder?" and wait for the answer. If something goes wrong, hermes doctor finds it.
Make sure it went through us0 of 3 steps
- Go to Usage & logs.
- You should see that request with the model name, tokens and cost.
- If nothing's there,
base_urlor the key isn't set correctly.
What an agent costs
Even a simple job can make an agent send many requests, each carrying the whole history again. So it costs more than a normal conversation. That's why we put a monthly cap on this key: if something runs away, spending stops at the number you chose.
What you learned
- Hermes is free and open source; only model use comes off your wallet.
- Four lines in
config.yamlconnect it to IranRouter. - Always put a cap on its key.
Keep your place
Sign in to the panel and each lesson and your path are saved, so you continue from the same spot on any device.