Explainer

Hermes Agent

Hermes Agent is Nous Research's self-improving, open-source AI agent — persistent memory, a TUI, cron, subagents, and chat gateways. This is the hub: a short overview, then the official repo, the install, and the full setup guide, all verified first-hand against v0.17.0.

By DK, Editor  ·  Last verified: 2026-06-21  ·  How we test  ·  Facts only — no hands-on score

01 / Definition

Hermes Agent (MIT, v0.17.0 as of 2026-06-19) runs continuously on your machine or server, learns skills from experience, and reaches you from the terminal or chat apps like Telegram and Discord. It is a general agent rather than a coding-specific tool. For the full definition see the explainer linked below; this page points you to the repo, install, and setup.

02 / What it does

  • What Hermes Agent is

    The plain-English explainer: Nous Research's self-improving agent, its memory/cron/subagents, the chat gateways, and how it differs from coding-specific agents like Claude Code.

  • The GitHub repo

    How the official NousResearch/hermes-agent repository is organized — the one-line installer vs cloning, the top-level structure, and where it stores data (~/.hermes).

  • Step-by-step setup

    Install Hermes, reload your shell, run hermes, choose a model, run the setup wizard, start the gateway, and verify — with commands captured first-hand from v0.17.0.

  • Where it fits

    How Hermes compares to coding-specific agents, and when a general self-hosted agent is the right tool versus a terminal coding agent.

04 / Who it's for

  • Developers who want a persistent, self-hosted agent that accumulates skills over time.
  • People who want to reach an agent from chat apps or run it on a schedule, not only from an IDE.
  • Tinkerers comfortable installing and running an open-source agent on their own server.

05 / Getting started

Start with what Hermes Agent is, then explore the GitHub repo or jump straight to the step-by-step setup. The one-line installer (curl on Linux/macOS/WSL2, PowerShell on Windows) gets you to a running hermes in minutes. The links below take you to each.

FAQ

What is Hermes Agent in one sentence?
It is Nous Research's open-source (MIT), self-improving AI agent that runs continuously, keeps a persistent memory, and works from the terminal or chat apps — a general agent of which coding is one capability.
How do I install Hermes Agent?
Run the one-line installer — curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash on Linux/macOS/WSL2, or the PowerShell one-liner on Windows — then reload your shell and run hermes. The setup guide linked here walks through it step by step (verified first-hand against v0.17.0).
Where is the official Hermes Agent repo?
github.com/NousResearch/hermes-agent (Nous Research, MIT). Treat third-party "awesome-hermes" lists and mirrors as unofficial. Our GitHub guide maps the repo structure and install.
Is Hermes Agent a coding agent?
Not exclusively — Nous Research positions it as a general self-improving agent. It can do coding work via subagents and terminal backends, but is also built for research, automation, and messaging. For terminal-only coding, OpenCode or Claude Code may fit better.