Hermes Agent Configuration Guide
Website: https://hermes-agent.nousresearch.com (click to jump!)
📌 About Hermes Agent Hermes Agent is an open-source terminal AI agent launched by Nous Research, supporting CLI / TUI / API Server three entry points, and can connect to any OpenAI compatible endpoint.
Source Code Address
- GitHub: NousResearch/hermes-agent
- Official Docs: hermes-agent.nousresearch.com/docs
1. Install Hermes Agent
Method 1: pip install (recommended)
Method 2: script install (follow main branch)
After installation, reload Shell:
2. Core Configuration Process
Hermes Agent settings are concentrated in the ~/.hermes/ directory:
| File | Purpose |
|---|---|
~/.hermes/config.yaml | All non-sensitive config: model, provider, terminal, compression, etc. |
~/.hermes/.env | API Key and other sensitive credentials |
1. Configure config.yaml (custom provider)
Open or create ~/.hermes/config.yaml, write the model block as custom Provider, and point base_url to LLMoxy:
You can also use CLI one-click write (automatically lands in config.yaml):
2. Configure .env (write API Key)
Write the LLMoxy token to ~/.hermes/.env:
OPENAI_API_KEY=<LLMOXY_API_KEY>xxxxxxxxxxxxxxxOr use CLI (recommended, automatically routes to .env without leaking to YAML):
Replace <LLMOXY_API_KEY>xxxxxxxxxxxxxxx with the real token obtained from the LLMoxy Console.
💡 Tip Please use a token from the auto group. Hermes Agent calls LLMoxy via OpenAI Chat Completions protocol;
base_urlmust include/v1.
3. Interactive Quick Configuration (optional)
If you don't want to manually edit YAML, run hermes model to enter the interactive wizard:
Select in order:
- In Provider options, pick Custom Endpoint
- Base URL enter
https://llmoxy.com/v1 - API Key paste LLMoxy token
- Model enter
grok-4.7
4. Launch Hermes
After launch, the welcome banner will display the currently active model and provider; you can enter a test prompt to verify connectivity.
Complete Configuration Example
# ~/.hermes/.env
OPENAI_API_KEY=<LLMOXY_API_KEY>xxxxxxxxxxxxxxx💡 Model naming rule tip
grok-4.7is the standard model ID on LLMoxy, viewable in the console "Model List". Other common ones:
- GPT series:
gpt-6.1-sol- Claude series:
claude-opus-5-5,claude-fable-5-2
Configuration Priority
Hermes Agent reads configuration following this priority (from high to low):
- Command line parameters
~/.hermes/config.yaml~/.hermes/.env- Built-in defaults
After modifying configuration, no need to restart Hermes; the next new session will automatically load the latest config.yaml.
