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 | bash

Select 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.

FieldValue
Provider nameOneRouter
Endpoint / Base URLhttps://onerouter.com/v1
API keyYour active OneRouter API key
ModelA complete OneRouter model slug
hermes model

Validate 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 check

Switch 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

SymptomHow to fix it
hermes is not foundReload the shell profile printed by the installer or reopen the terminal.
401Re-enter the API key in the custom endpoint and verify the saved credential source.
404Use https://onerouter.com/v1 and do not append a chat or responses path.
Model not foundSelect the complete slug returned by OneRouter and confirm key access.
Configuration looks correct but the old model respondsStart a new Hermes session after changing the default model.