Hermes Agent
Install Hermes Agent, select a custom OneRouter endpoint, validate the configuration, and switch models safely.
Install Hermes Agent
Use the official installer, reload the shell profile it updates, then run the environment check before configuring a provider.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bashSelect a custom endpoint
Run hermes model, select Custom endpoint, and enter the OneRouter values below. Use a complete model slug available to the current key.
Keep API keys in environment variables or the client's protected credential store. Never commit keys to a project, paste them into chat, or include them in screenshots.
| Field | Value |
|---|---|
| Provider name | OneRouter |
| Endpoint / Base URL | https://onerouter.com/v1 |
| API key | Your active OneRouter API key |
| Model | A complete OneRouter model slug |
hermes modelValidate configuration
Run the configuration check, then launch Hermes and use a minimal prompt. Resolve endpoint or authentication errors before enabling tools, gateways, memory, or scheduled automation.
hermes config
hermes config checkSwitch models
Run hermes model again to change the default. After each change, start a new session and repeat the minimal prompt so an old session does not hide a configuration problem.
Troubleshooting
| Symptom | How to fix it |
|---|---|
hermes is not found | Reload the shell profile printed by the installer or reopen the terminal. |
| 401 | Re-enter the API key in the custom endpoint and verify the saved credential source. |
| 404 | Use https://onerouter.com/v1 and do not append a chat or responses path. |
| Model not found | Select the complete slug returned by OneRouter and confirm key access. |
| Configuration looks correct but the old model responds | Start a new Hermes session after changing the default model. |