# Hermes Home Folder

> The folder where Hermes keeps all its files.

**Field:** Artificial Intelligence  
**Category:** Hermes Agent  
**Also known as:** ~/.hermes, HERMES_HOME

## Think of it like

It is like a bag that holds all a helper owns.

## Definition

The Hermes home folder is where Hermes Agent keeps its settings and all it learns. By default it is ~/.hermes, and the HERMES_HOME variable can move it. It holds config.yaml, the .env file with your keys, SOUL.md, the memory and skill folders, cron jobs, chats and logs. Copy this folder and you copy the agent.

## Example

Leo moves to a new laptop. He copies his ~/.hermes folder across, and his agent comes with its memory and skills.

## Example code

```console
ls ~/.hermes
```

See what the agent keeps.

## Why it matters

It is the agent's whole self on disk, so backing it up backs up the agent.

## Common mistake

Pointing two agents at one home folder. Both write memory, and each picks up the other's notes.

## Three principles

- **~/.hermes by default.** HERMES_HOME moves it.
- **Settings and learning.** All in one place.
- **One agent per home.** Never two.

## Related terms

- [Hermes config.yaml](https://learn.benibix.com/term/ai/hermes-config-yaml)
- [Hermes Profile](https://learn.benibix.com/term/ai/hermes-profile)
- [Hermes MEMORY.md](https://learn.benibix.com/term/ai/hermes-memory-md)

---

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