Hermes-Bot-Mode README

The project's README from github.com/NousResearch/Hermes-Bot-Mode. As one markdown file: README.md.

Hermes Bot Mode

📦 ARCHIVED — Bot Mode now ships built into Hermes Desktop. As of hermes-agent #87886, Bot Mode is a bundled, default-on Desktop plugin (toggle in Settings → Plugins) with the multi-source roster included — bots from every connection registered in Settings → Connections. Development continues in-tree at apps/desktop/src/plugins/hermes-bots/. File issues and PRs against NousResearch/hermes-agent. No manual install is needed on current Desktop builds.

A desktop-app plugin for Hermes Agent (installs where the desktop app runs — see Install) that turns your agent profiles into a roster of named bots — each with its own chat, avatar, personality, and schedule.

Hermes Agent desktop plugin License: MIT

image

What you get

How it works

A bot is a Hermes profile — isolated config, memory, skills, credentials, and chat history under ~/.hermes/profiles/<name>/. This plugin is a UI over that primitive:

No core patches, no background daemons, no extra storage: everything is standard Hermes surface.

Screenshots

| New Agent

image

| PetDex avatars

image

| Agent 2 Agent Communications

image

Install

This is a desktop plugin — it must be installed on the machine running the Hermes desktop app, not on the gateway. Desktop plugins load from the app-side ~/.hermes/desktop-plugins/ directory; if you use a remote/SSH gateway, installing on the gateway box does nothing. (Example: gateway on your homelab, desktop app on your MacBook → install on the MacBook.)

git clone https://github.com/NousResearch/Hermes-Bot-Mode ~/.hermes/desktop-plugins/hermes-bots

(or download plugin.js into ~/.hermes/desktop-plugins/hermes-bots/)

Then reload plugins in the Hermes desktop app (Ctrl+K → "Reload desktop plugins") or restart the app. A Bots tab appears next to Sessions, and a Routines tile docks beside the conversation.

Requirements

Notes

License

MIT © Nous Research

Hermes-Bot-Mode (NousResearch/Hermes-Bot-Mode)

Searching Database…

668 ·GitHub
archived
What is this?A desktop plugin for the Hermes Agent app that turns your agent profiles into a roster of named bots, each with its own chat, avatar, personality, and schedule, plus bot-to-bot messaging. The repo is archived because this feature is now bundled directly into Hermes Desktop.
Is this a standalone app or does it plug into something else?It's a desktop plugin, not a standalone app — it loads inside the Hermes Desktop app from a local plugins folder and only works alongside a running Hermes profile/gateway, never on the gateway machine itself.
How do I install it now that it's archived?As of hermes-agent #87886 you don't need to install anything — Bot Mode ships built-in and default-on (toggle in Settings → Plugins). On older Desktop builds, download plugin.js into ~/.hermes/desktop-plugins/hermes-bots/ and reload plugins (Ctrl+K → 'Reload desktop plugins').
What do I need on top of Hermes Desktop for this to work?Any recent Hermes desktop build with the plugin SDK. Advanced profile editing and AI avatar generation additionally need the profiles./image.generate gateway RPCs, which ship in hermes-agent builds from roughly mid-2026 onward.
Does it work with older Hermes gateways, and can bots interrupt each other mid-chat?Yes, but with reduced features — the plugin feature-detects older gateways and degrades gracefully, so the roster always works while Advanced editing and avatar generation only light up when the newer RPCs exist. Also, bot-to-bot delivery is per-invocation, so you can't yet interrupt a bot mid-conversation.
What is a 'bot' here, technically?Each bot is just a Hermes profile — its own isolated config, memory, skills, credentials, and chat history stored under ~/.hermes/profiles/.
Can bots talk to each other?Yes — every bot has a persistent Bot Chat conversation, and bots message each other via real CLI handoffs with attribution, following a protocol taught in their SOUL.md.
Can multiple bots collaborate in one conversation?Group chats support 2-6 bots in a shared room: your message triggers up to three serial rounds where @mentioned bots reply, with hard caps of 10 messages per turn and 3 rounds to stop runaway loops.
Why is this repo archived?Because Bot Mode has been folded directly into Hermes Desktop as a bundled, default-on plugin, so active development moved to the main hermes-agent repository.
Size
10.3 MB
Stars
668
Updated
CommitAug 17
Age
2mo
Commits · 90 Days