Hermes Agent

An open-source AI assistant that doesn't just chat back — it actually does things. This page explains, in plain English, what it is, how it works, and what makes it different from a normal chatbot.

A chatbot with hands

Most AI assistants are chatbots: you type a question, and they reply with words. Hermes Agent is an agent — a chatbot that can also act. Give it a task in ordinary language and it can run commands on a computer, create and edit files, search the web, and work through multi-step jobs on its own, checking its own progress as it goes.

It's built by Nous Research and is open source (MIT-licensed). It belongs to the same family as tools like Claude Code and OpenAI's Codex — but where those are tied to one company's models, Hermes works with whichever AI "brain" you choose, and it runs on hardware you own.

Info

So is this just ChatGPT? No. ChatGPT is a chat service you visit. Hermes is software you run yourself — an assistant that lives on your machine (or server), has real tools, and keeps working even when you're not watching.

How it works

Using Hermes feels like chatting, but behind the scenes it follows a simple loop:

  1. You ask for something in plain language — "check this price every day and tell me if it drops".
  2. It plans — it works out what steps the task needs, in what order.
  3. It acts — using its tools: the terminal, files, web search, and more.
  4. It checks — it verifies the result rather than assuming it worked.
  5. It reports — and it can reach you wherever you are.

It can also run jobs on a schedule (like a price watch that fires every morning), and for big tasks it can spin up smaller "helper" agents to work on parts in parallel, then gather their results.

  • Runs real commands and edits real files
  • Multi-step tasks, not one-shot replies
  • Verifies work before reporting done
  • Scheduled jobs and background monitoring
  • Can delegate subtasks to helper agents

Tip

A good mental model: hiring a very capable assistant who actually does the job, rather than one who only tells you how you might do it yourself.

Memory — it actually remembers you

Most chatbots start every conversation from scratch. Hermes keeps persistent memory: who you are, your preferences, details of your setup, and lessons it has learned. Every new session starts with that knowledge already loaded — you don't have to repeat yourself.

Crucially, that memory is human-readable: plain notes and files you can open and edit, plus a searchable history of past conversations. It isn't a black box of inscrutable data. Memory is also pluggable — it can store what it knows in different backends, and separate "profiles" keep different contexts fully isolated from each other.

Info

Think of it like an assistant who keeps a notebook about you and reads it at the start of every shift — so they remember your name, your preferences, and how you like things done.

Skills — it learns on the job

The most distinctive part of Hermes is skills. When it figures out how to do something well — say, adding a page to this very website — it can save that procedure as a reusable "skill". Next time the same kind of task comes up, the skill loads automatically and the job is done faster and more consistently, with the mistakes of the first attempt already learned out.

That makes Hermes self-improving: the more it works with you, the better it gets at the things you actually ask it to do. Skills are stored as readable files too, so you can see exactly what it "knows" and edit it.

Where you can talk to it

One agent core, many surfaces — you use the same assistant everywhere, with the same memory and skills:

Ways to talk to Hermes
SurfaceWhat it's for
Desktop appA native app with streaming chat, file drag-and-drop, and a command palette
Terminal (CLI)Quick queries and scripting from the command line
Web dashboardAdmin panel: channels, memory, schedules, and an embedded chat
Messaging platformsTelegram, Discord, Slack, WhatsApp, Signal, email and more — with full tool access, not just chat
IDEsPlugins for VS Code, Zed and JetBrains for coding help where you code

It runs on Linux, macOS and Windows, and because it's a gateway-style agent, the same instance can answer you on the desktop and ping you on a messaging app from a scheduled job.

Bring your own brain

Hermes doesn't force you into one AI provider. It works with any of the major ones — OpenAI, Anthropic, Google, DeepSeek, xAI, OpenRouter, and more — including local models you run on your own hardware. You can swap models mid-task, and if a provider goes down or runs slow, it can rotate through credentials automatically.

My setup

I run Hermes on my Raspberry Pi 5 home server, alongside the other services behind davn.uk. All of its memory and data live on my own hardware, and I talk to it mostly from the desktop app. This very page was written by it, working from a short brief — which is the honest demo of what an agent does.

Find out more

Documentation

hermes-agent.nousresearch.com/docs — the full manual, including how to install and configure it.

Source code

github.com/NousResearch/hermes-agent — open source under the MIT licence.