# Hermes USER.md

> The Hermes file about you and what you like.

**Field:** Artificial Intelligence  
**Category:** Hermes Agent  
**Also known as:** USER.md, Hermes user profile

## Think of it like

It is like a card a helper keeps about you.

## Definition

USER.md is the file where Hermes Agent keeps what it knows about you, such as your name, your job and how you like replies. It sits next to MEMORY.md in ~/.hermes/memories and holds up to 1,375 characters by default. The agent writes it with the same memory tool. It loads at the start of each session, like MEMORY.md.

## Example

Leo tells Hermes he likes short answers in metric units. It saves both to USER.md, and every later chat follows them.

## Example code

```console
cat ~/.hermes/memories/USER.md
```

See what the agent knows about you.

## Why it matters

You should not have to explain yourself again in every new chat.

## Common mistake

Writing facts about yourself in SOUL.md. That file is the agent's voice; USER.md is about you.

## Three principles

- **About you.** Not the agent.
- **1,375 characters.** By default.
- **Written by the agent.** Via the memory tool.

## Related terms

- [Hermes MEMORY.md](https://learn.benibix.com/term/ai/hermes-memory-md)
- [Hermes SOUL.md](https://learn.benibix.com/term/ai/hermes-soul-md)
- [Hermes Learning Loop](https://learn.benibix.com/term/ai/hermes-learning-loop)

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