# Hermes config.yaml

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

**Field:** Artificial Intelligence  
**Category:** Hermes Agent  
**Also known as:** ~/.hermes/config.yaml, Hermes configuration file

## Think of it like

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

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

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

## Example code

```console
hermes config edit
hermes config set OPENROUTER_API_KEY sk-or-...
```

Open the file, or save a key where it belongs.

## Why it matters

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

## Common mistake

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

## Three principles

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

## Related terms

- [Hermes Home Folder](https://learn.benibix.com/term/ai/hermes-home)
- [YAML Ain't Markup Language (YAML)](https://learn.benibix.com/term/development/yaml)
- [.env File](https://learn.benibix.com/term/development/env-file)
- [hermes setup Command](https://learn.benibix.com/term/ai/hermes-setup-command)

---

Source: https://learn.benibix.com/term/ai/hermes-config-yaml
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
