Skip to content
BENIBIX Learn

Hermes config.yaml

AI🪽 Hermes AgentHermes Agent Basics

Also known as ~/.hermes/config.yaml, Hermes configuration file

The file that holds all the Hermes settings that are not secret.

Think of it like

It is like a phone's settings page, kept as a file.

Example

Mia wants more room for memory. She opens the file with hermes config edit and raises the memory limit.

Why it matters

Keys sit in one file and settings in the other. So you can share your settings and keep your keys safe.

Definition

config.yaml is the main settings file of Hermes Agent, kept in its home folder. It holds each setting that is not a secret, such as the model, the terminal, memory limits and tools. Keys and tokens go in the .env file next to it. A flag you type beats config.yaml, and config.yaml beats .env.

Example code

console
hermes config edit
hermes config set OPENROUTER_API_KEY sk-or-...
Open the file, or save a key where it belongs.

Common mistake

Putting an API key in config.yaml. Use hermes config set, which sends secrets to .env.

Key takeaways

  1. 1
    Settings, not secrets. Keys go in .env.
  2. 2
    Flags win. Then config.yaml.
  3. 3
    hermes config set. Picks the right file.