Skip to content
Skip to the story

A promise at the edge of the group chat.

Hermes AgentTwenty promises.
All checked.

Nous Research posted twenty things you should be able to do with your agent. We read the documentation to see which ones hold.

Hermes Agent is Nous Research’s open-source AI agent: MIT licensed, run on your own machine or a server, with memory that persists between sessions and skills it writes for itself. Checked against its own documentation, 15 of the 20 promises in its 5 October post are documented, 4 are partly documented and 1 is a promise rather than a feature.

An original folkfox special. 6 October 2026.

A promise is a map.
The documentation is the ground.

Chapter one. The invitation.

Suppose your assistant lives in the family group chat.

Picture a Saturday that has not started yet. In the family group chat, a message lands before anyone is up. The aquarium opens at ten. The nap window is one o’clock. There is a café four minutes away, and it has a high chair. This is a hypothetical scene, not a screenshot. It is built from what two people actually posted this week.

On the evening of 5 October, Sergey Kaplich wrote that he had set up a Hermes agent for his family, with a separate profile holding the essentials about each member and a Telegram group chat shared with his wife. The next morning, witcheer described the same Hermes Agent Telegram set-up, with the same examples: the aquarium, the nap, the rainy afternoon. Both are self-reports, and the second repeats the first. Neither is a test.

That is the pull of the thing, and it is real. An assistant that remembers the nap time is a different animal from a chat window that forgets you between sessions. The question this page asks is narrower, and more useful: what, exactly, is it allowed to remember, do and say, and who decided?

Look a little closer

We could not verify who either poster is, or how their set-up is configured, and we have not tried. They are quoted for what they say, not as evidence that the arrangement works for anyone else. The job-search story in chapter eight gets the same treatment.

Family chatan imagined morning
  1. Family agent

    Good morning. The aquarium opens at ten, the nap window is one o'clock, and there is a café four minutes away with a high chair.

The agent asks: "Shall I remember that the baby naps at one?"

Illustrative scene. No model runs here, and your three choices stay on this page.

Follow the trail

Chapter two. The manifesto.

Twenty sentences, and one signature line.

At 22:43 Malta time on 5 October, Nous Research posted a list. Twenty lines, each beginning “You should be able to”, each about an agent: smarter models, cheaper models, local models, memory you control, a machine that never touches the internet, code you can read and change. The last line is the signature. “Your agent should be yours.” When we read it on 6 October the post showed about 122,000 views and 3,300 likes.

Attention is not evidence. A list this good is easy to cheer, because everybody wants it. A fox does not cheer a list. A fox follows each line to the ground and checks whether anything has stood there.

The summary that did the rounds on 6 October told the week another way, as a major update with desktop, voice and plugin upgrades. We will come back to that headline in chapter nine.

Our method

For each line we looked for a sentence in Nous’s own documentation, repository or pricing page that says the thing can be done. Documented means a page says so. It does not mean we tested it, and it does not mean it works well. Partly means a page covers some of the line. A promise means no page could settle it. That makes this page an audit of promises, not a hands-on Hermes Agent review.

NoneTenAll twenty

10 of 20

Optional. Lock a guess now and chapter three will answer it.

Follow the trail

Chapter three. The audit.

Guess first. Then open the cards.

Each card holds one promise, word for word. Choose what you think the documentation says, then open the card. There is no penalty, and nothing leaves this page.

The verdicts are ours, and you can disagree. Every card links the sentence we relied on, so you can check our reading against the page itself.

A note on “documented”

Documentation moves faster than anyone’s reading of it. The project tagged six releases between 31 August and 24 September. Treat each verdict as dated 6 October 2026.

0 of 20 opened.

  • Documented 0
  • Partly 0
  • A promise 0

The brain

Models: which one, where, how hard it thinks.

01

“You should be able to use smarter models in your agent.”

What do you think the documentation says?

02

“You should be able to use cheaper models in your agent.”

What do you think the documentation says?

03

“You should be able to use local models in your agent.”

What do you think the documentation says?

04

“You should be able to use a different model for every job.”

What do you think the documentation says?

05

“You should be able to switch models in the middle of a conversation.”

What do you think the documentation says?

The data

What it holds, forgets and reaches.

06

“You should be able to choose what data your agent has.”

What do you think the documentation says?

07

“You should be able to choose what it remembers and what it forgets.”

What do you think the documentation says?

08

“You should be able to choose what computer your agent runs on.”

What do you think the documentation says?

09

“You should be able to run it on a machine that never touches the internet.”

What do you think the documentation says?

The home

Where it lives and how you reach it.

10

“You should be able to run it while your laptop is closed.”

What do you think the documentation says?

11

“You should be able to reach it from the apps you already use.”

What do you think the documentation says?

12

“You should be able to choose how your agent thinks.”

What do you think the documentation says?

The mind

What it can read, see and learn.

13

“You should be able to read the prompt it runs on.”

What do you think the documentation says?

14

“You should be able to see every tool it has, and turn off the ones you don't want.”

What do you think the documentation says?

15

“You should be able to teach it something once and never explain it again.”

What do you think the documentation says?

16

“You should be able to know what it did, and when, and why.”

What do you think the documentation says?

The keys

Ownership, in the end.

17

“You should be able to export your agent.”

What do you think the documentation says?

18

“You should be able to read the code.”

What do you think the documentation says?

19

“You should be able to change the code.”

What do you think the documentation says?

20

“Your agent should be yours.”

What do you think the documentation says?
Follow the trail

Chapter four. The notebook.

A small notebook, not a brain.

Say “persistent memory” and most people picture a hive mind that never forgets. Open the manual and you find something humbler.

Hermes keeps two small files. MEMORY.md holds the agent’s own notes: environment facts, conventions, things it learned. USER.md holds what it knows about you. The limits are in the documentation: about 2,200 characters for the first and 1,375 for the second. That is a few paragraphs, not a life.

The files load into the prompt at the start of every session, so everything in them is always in the agent’s head. The limit is the design. Character limits keep memory focused, and it does not auto-compact. The agent decides what to save, and it saves automatically, so you do not need to ask.

Everything else lives in a second place. Every session is stored in a local SQLite database with full-text search, so the agent can find something you discussed weeks ago even if it is not in the notebook. A notebook for what must always be known. An archive for what can be found.

Look a little closer

For deeper memory, Hermes ships plugins called memory providers. Where a provider stores the data is the first question to ask of each one. The promise to choose what it remembers is only as strong as the place the memory sits.

You are the agent's editor.
Keep what must always be known.

0 of 2,200 characters used

35 things the family chat produced this month. Tick up to 2,200 characters.

Left out of the notebook

Everything you leave out is still in session history, found by search when needed.

Illustrative family notes. The 2,200-character limit is from the memory documentation; the notes are ours.

Follow the trail

Chapter five. The forge.

Teach it once.

Here is the promise people repeat most: teach it something once and never explain it again. The mechanism is a skill.

A skill is a written procedure the agent keeps in its skills folder. The agent can create, update and delete its own through a tool called skill_manage. When it works out a non-trivial workflow, it can save the approach for next time. Every installed skill also becomes a slash command.

You can teach it on purpose, too. The /learn command turns something you already know, or a pile of reference material, into a reusable skill without hand-writing the file. Skills follow the open agentskills.io standard and load only when relevant, so a long library does not clog the conversation.

Memory stores small durable facts. Skills store longer procedures. The documentation describes the two working together as the self-improvement loop.

Look a little closer

Skills installed from a hub pass a security scanner that checks for data exfiltration, prompt injection and destructive commands. A skill is also a way to hand an agent instructions, which is why that scanner exists.

What the agent would keep

Slash command:

A teaching sketch. Hermes writes and manages its own skill files, so use this to plan the lesson, then ask the agent to /learn it.

Follow the trail

Chapter six. The address.

Where does it sleep?

A chatbot lives on someone else’s computer. A Hermes agent lives where you put it.

The README lists seven terminal backends: local, Docker, SSH, Singularity, Modal, Daytona and Vercel Sandbox. It says to run it on a five-dollar VPS, a GPU cluster or serverless infrastructure, and not to tie it to your laptop.

Where it lives decides what it can touch, what it costs and what happens when you shut the lid. The default local backend runs commands directly on your machine with no isolation. Docker adds hardening, and SSH keeps the work on another server.

On privacy, the FAQ is plain: API calls go only to the provider you configure, there is no telemetry, and conversations, memory and skills are stored locally in the .hermes folder. That is the vendor’s statement about its own software. The code is open, so it can be checked, but we have not audited it.

Money is the other address. Nous Portal pricing is a subscription ladder: Plus is $20 a month with $22 of monthly credits, and there is a free tier with free models only. The software stays free either way, and you can skip Portal and bring your own provider.

Where does it sleep?
What does it think with?
How do you reach it?

Choose one from each row to see what the documentation says about your sketch.

Follow the trail

Chapter seven. The keys.

Who else can talk to it, and what can it do?

The same features that make an agent useful make it risky. It reads files, runs commands, browses the web and answers messages. The Hermes Agent security documentation is candid that this needs guardrails, and it lists them.

Before it runs a command, Hermes checks it against a list of dangerous patterns. The approval system has three modes. Smart, the default, asks a second model to assess the risk. Manual always asks you. Off disables the checks, the same as running in YOLO mode.

Strangers get a different door. An unknown person who messages the bot receives a one-time pairing code, and the owner approves it from the command line. Codes expire after an hour, and five failed approvals lock the door for an hour.

Context files are scanned for prompt injection and invisible Unicode characters before they reach the prompt. Credential stores such as .ssh and .aws are blocked outright. None of that makes an agent safe to point at anything. It makes the choices visible, which is the point of this chapter.

What the documentation does not promise

Container backends skip the dangerous-command checks because the container itself is the boundary. Keeping that boundary sound is your job, not the checker’s. We found no independent security audit of Hermes in the sources we read, and we did not run one.

manualsmart (default)off

A stranger messages the bot

  1. A stranger sends your bot a direct message.
  2. The bot replies with a one-time pairing code and nothing else.
  3. You approve the code from the command line, within the hour.

Press next to walk the door.

Illustrative controls. Nothing here runs Hermes or sends a message.

Follow the trail

Chapter eight. The evidence trail.

Who is saying it, and how would they know?

You have read the promises and the manual. Now the fox leaves three clues on the path and asks you to name the kind of evidence each one is.

There is no score, and no verdict on Hermes waiting at the end. The point is the habit: before you repeat a claim about an agent, name who is making it.

Look a little closer

The job-search report is a single self-reported account, dated 20 September 2026. It credits a whole workflow, not only an agent, and it cannot separate what Hermes did from what the person, the market and a job-search tool did. The best that can be said is that it is a real person describing a real outcome.

The fox’s evidence trail

Clue 1 of 3

Name who is speaking. Follow the clue only as far as it goes.

What kind of evidence is this?
Continue reading
Follow the trail

Chapter nine. The headline and the record.

Five claims from a summary, checked.

On 6 October a news-app summary of Hermes Agent was doing the rounds, the kind that fits a whole story into four lines. We read it as a compression, and checked each claim against the record.

Open each claim to see its stamp. Three hold in some form. One does not hold as stated, and one has turned a credit into a price.

A summary is only as good as the care taken in squeezing it. The habit worth keeping is to ask which sentence the summary came from.

  1. “It lets users run powerful AI anywhere, from local machines to servers.”

  2. “It supports over 300 models and platforms such as Telegram and Discord.”

  3. “A major 5 October update added desktop enhancements, voice features and better plugins.”

  4. “Real users report landing job interviews and organising family activities in group chats.”

  5. “It is backed by a $22 monthly subscription option.”

Follow the trail

Chapter ten. The charter.

You can own the code and still rent the brain.

Return to the family group chat. Your three first instincts are waiting in the charter below, along with the choices you made on the way.

Here is what the audit found. Most of what Nous promises is written down. The lines that are only partly written down are the ones that matter most: what an agent can reach, what it quietly keeps, and how you would know what it did.

And “yours” has a boundary. The code is MIT licensed, and the notebook sits in your own folder. The models are mostly someone else’s, and the best are rented by the token or by the month. You can own the harness and still rent the brain.

So write the charter before you write the first prompt. It takes two minutes, and it is the one document that no vendor can write for you.

Your charter

    A SOUL.md starter

    SOUL.md is the agent’s identity file, loaded first in its prompt, per the Hermes documentation. This is a starter you edit, not a configuration we have tested.

    Quick answers

    What is Hermes Agent?

    Hermes Agent is Nous Research's open-source AI agent. It is MIT licensed, runs on your own machine or a server, remembers between sessions, writes reusable skills and answers in apps such as Telegram and Discord.

    Is Hermes Agent free, and what is Nous Portal pricing?

    The software is free and open source under the MIT licence. You pay for the models it calls. Nous Portal pricing is a subscription option: Plus is $20 a month with $22 of monthly credits, and there is a free tier with free models only.

    Where does Hermes Agent keep its memory?

    Locally, in the .hermes folder. Two small files hold persistent memory, with limits of about 2,200 and 1,375 characters, and a local SQLite database holds searchable session history.

    Can Hermes Agent run offline?

    Yes, with a local model such as one served by Ollama or llama.cpp, according to the FAQ. Chat apps like Telegram still need a network, so an offline agent is a terminal agent.

    Is it safe to put Hermes Agent in a family group chat?

    That depends on the setup. Unknown senders get a one-time pairing code the owner must approve, and risky commands pass an approval check. The default local backend has no isolation, so many people choose Docker or a separate server.

    What does 'your agent should be yours' mean?

    It is the closing line of a twenty-line post Nous Research published on 5 October 2026. It promises control of models, data, memory, hardware and code. Our audit found fifteen of the twenty lines documented and one a promise rather than a feature.

    Sources

    1. Nous Research published twenty 'you should be able to' lines on 5 October 2026, ending 'Your agent should be yours.'Primary: Nous Research on X
    2. Hermes Agent is free and open source under the MIT licence.Primary: Hermes home page
    3. Hermes lists seven terminal backends and can run on a $5 VPS or serverless infrastructure.Primary: project README
    4. Persistent memory is bounded: MEMORY.md at 2,200 characters and USER.md at 1,375, with session search in SQLite.Primary: memory documentation
    5. The agent creates, updates and deletes its own skills, and /learn turns knowledge into a skill.Primary: skills documentation
    6. Approval modes are smart, manual and off, and unknown users receive a one-time pairing code.Primary: security documentation
    7. API calls go only to the provider you configure, and there is no telemetry.Primary: FAQ
    8. The configuration page documents terminal backends and a per-task thinking level.Primary: configuration documentation
    9. The CLI reference documents hermes backup, hermes sessions, hermes logs, /model and hermes tools.Primary: CLI reference
    10. SOUL.md is the agent's primary identity, loaded first in the system prompt.Primary: personality documentation
    11. Each Bot is a profile with its own model, memory, skills and credentials.Primary: Bot Mode documentation
    12. The messaging gateway connects Telegram, Discord, Slack, WhatsApp, Signal and more from one process.Primary: messaging documentation
    13. Nous Portal offers 300+ frontier models and is the recommended way to run Hermes Agent.Primary: Nous Portal documentation
    14. Plus is $20 a month with $22 of monthly credits; Super $100 with $110; Ultra $200 with $220.Primary: Nous Portal pricing
    15. The newest tagged release found is v0.21.5 of 24 September 2026.Primary: GitHub releases
    16. A software engineer reported 21 serious applications, 7 interview processes and 2 offers in 8 weeks.Self-reported: GitHub issue
    17. Sergey Kaplich described a Hermes agent in a family Telegram group on 5 October 2026.Self-reported: X post
    18. witcheer described a family profile and Telegram group on 6 October 2026, repeating Kaplich's examples.Self-reported: X post
    What the public record actually dates
    DatePublic recordOn this site
    Version 0.21.0 tagged.AI consultancy
    Version 0.21.1 tagged.What did Dario see?
    Version 0.21.5 tagged: Desktop plugin SDK, Simple and Advanced modes, voice shortcuts. Full notes deferred to 0.22.0.Who taught Claude to care?
    Nous Research posts twenty promises at 22:43 Malta time.The newsroom

    What we could not check

    We read documentation and did not test every feature, so a documented line is a claim by the maker, not a result. We found no independent benchmark of Hermes against other agents, and no independent security audit. We did not audit the code. The post’s view and like counts were read on 6 October and will have moved. Desktop, voice and Bot Mode features changed during the weeks we looked, so read the date on every verdict.

    Back to the beginning

    Cookie preferences

    folkfox uses data the way we use strategy: only when it earns its place.