# Hermes SOUL.md

> The file you write to set how Hermes talks and acts.

**Field:** Artificial Intelligence  
**Category:** Hermes Agent  
**Also known as:** SOUL.md, Hermes personality

## Think of it like

It is like the part an actor plays: who they are, and how they talk.

## Definition

SOUL.md is the file that sets who Hermes Agent is: its personality, tone and style. It lives in the Hermes home folder, not in your project, and comes first in the system prompt. Hermes makes a starter file if there is none, and never writes over yours. You write it yourself. For a change that lasts one session, use the /personality command instead.

## Example

Sara wants a calm, plain-spoken assistant. She rewrites SOUL.md to say so, and every chat after that sounds that way.

## Example code

```console
hermes config edit
$EDITOR ~/.hermes/SOUL.md
```

Open the agent's identity file.

## Why it matters

It is the one place that decides how the agent sounds, everywhere it runs.

## Common mistake

Putting project rules in SOUL.md. Those belong in AGENTS.md in the project.

## Three principles

- **Who the agent is.** Tone and style.
- **First in the prompt.** Slot one.
- **You write it.** Hermes never overwrites.

## Related terms

- [Hermes USER.md](https://learn.benibix.com/term/ai/hermes-user-md)
- [Hermes Context Files](https://learn.benibix.com/term/ai/hermes-context-files)
- [System Prompt](https://learn.benibix.com/term/ai/system-prompt)

## Told apart from

- [SOUL.md vs USER.md (Hermes)](https://learn.benibix.com/compare/hermes-soul-md-vs-hermes-user-md): People think SOUL.md is where facts about them go. It is not. SOUL.md sets who the agent is, its tone and style, and you write it yourself. USER.md holds who you are, your name and how you like replies, and the agent writes it. The two never feed each other.

---

Source: https://learn.benibix.com/term/ai/hermes-soul-md
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.
