AI AgentAdvanced10 min read

Build a Team of AI Agents with Hermes Bot Mode in 30 Minutes

Create a collaborative team of AI agents that hand off tasks to each other, automating complex workflows without coding.

Build a Team of AI Agents with Hermes Bot Mode in 30 Minutes

Overview

Most AI assistants forget everything the moment you close the tab. You re-explain who you are, what you're working on, and how you like things done — every single time. Hermes Bot Mode, a free, open-source feature from Nous Research (the lab behind the Hermes model series), throws that pattern out. Instead of starting each task in a blank chat, you build a roster of named, persistent AI bots that live in the Hermes desktop app. Each bot keeps its own role, model, memory, skills, and avatar — and, crucially, the bots can talk to each other, so you can assemble a small team that hands work back and forth like real colleagues: a researcher passes sources to a writer, who passes a draft to an editor.

The Hermes Agent desktop app — free, open-source under the MIT license, installable on macOS, Windows, and Linux.
The Hermes Agent desktop app — free, open-source under the MIT license, installable on macOS, Windows, and Linux.

Bot Mode shipped on 16 August 2026 inside Hermes Agent v0.20.3 — Nous co-founder Teknium first released it as a one-day public beta on 14 August, then it landed built into the main desktop app for everyone. It's MIT-licensed and completely free, and here's the part most write-ups skip: every bot is a real Hermes agent with real system access, so a team of bots is genuinely powerful and genuinely needs your supervision. This guide takes you honestly from install to a working 3-bot content team in about 30 minutes — with detailed, do-this-then-that steps, and a clear-eyed look at what to watch out for.


Difficulty: Beginner-friendly · You'll need: the free Hermes desktop app (or CLI) and one model connection (Nous Portal, OpenRouter, OpenAI, or any endpoint) · Cost: the app is free; you pay only for whatever model you point it at · Updated: August 2026

Who This Is For

  • Solo founders and freelancers who want the leverage of a small team without hiring one — a "department" of specialized bots you build once and reuse forever.
  • Knowledge workers doing repeatable, multi-step work (research → draft → edit, or triage → summarize → respond) who are tired of copy-pasting between separate chats.
  • Privacy-conscious and self-hosting fans who'd rather run agents on models and hardware they control than pipe everything through one cloud vendor.
  • Tinkerers who want to understand agent-to-agent collaboration hands-on, not just read about it.
  • What You'll Learn

  • How to install Hermes Agent (via the desktop app or a one-line terminal command) and connect a model.
  • What a "Bot" actually is — role, pinned model, memory, skills, persona, avatar — and how to configure one well.
  • How to make bots hand off work to each other with @mentions inside a shared room.
  • How to run a full research → write → edit pipeline, schedule it, and keep a human in the loop where it matters.
  • Why Bot Mode Matters

    A normal chatbot session is disposable — close it and the context evaporates. Bot Mode makes your agents durable teammates you build once and reuse forever. Configure a "Researcher" bot with a search-friendly model and a research skill, and it's still that exact bot tomorrow, next week, next month, remembering how you like sources presented.

    The real multiplier is collaboration. Because bots can @mention each other and gather in shared rooms (2–6 bots, up to three rounds of turns per message), one person can operate what looks like a whole content desk: research, drafting, and editing flowing between specialists — without you shuttling text between windows. It's the closest a solo builder gets to a team, and it runs on models and hardware you choose.

    How the handoff works: bots pass work to each other with @mentions in a shared room — researcher → writer → editor.
    How the handoff works: bots pass work to each other with @mentions in a shared room — researcher → writer → editor.

    The honest caveat, up front: this is not magic, and it is not a sandbox. Nous states plainly that Bot Mode "adds no new safety model of its own" — every bot has the same real system access as any Hermes agent. More bots acting autonomously means more ways for a small mistake to compound. So you supervise a bot team; you don't just unleash it and walk away.

    Before You Start


    Hermes Agent — Quickstart (official docs)

    The canonical install and first-run guide from Nous Research. Always check here for the current commands and Bot Mode notes.

    hermes-agent.nousresearch.com

    The Step-by-Step Build

    Step 1: Install Hermes Agent

    You have two paths — pick whichever fits you.

    The easy way (desktop app): go to hermes-agent.nousresearch.com, download the installer for macOS or Windows, run it, and open the app. That's it — you'll land on the Bot roster screen.

    The terminal way (CLI): if you prefer the command line or you're on Linux/WSL2, install in one line:

    
    

    macOS / Linux / WSL2

    curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

    Windows (PowerShell)

    iex (irm https://hermes-agent.nousresearch.com/install.ps1)

    After it finishes, confirm it's installed by running hermes --version. If you see a version number, you're good.

    Pro tip: the desktop app and the CLI share the same profiles and bots, so you can start in the GUI to get oriented and drop to the terminal later for scripting and automation.

    Step 2: Connect a model

    A bot is only as capable as the model behind it, and Hermes lets you use any of several:

  • Nous Portal — the fastest start. One command wires up a model plus a few built-in web tools:
  • 
      hermes setup --portal
      
  • OpenRouter or OpenAI — if you already have an API key, point Hermes at it for a wider menu of models and finer cost control.
  • Any custom endpoint — including a local model, if you want everything on your own hardware.
  • Pro tip: you don't have to pick one model for everything. Later you'll pin a cheap, fast model to high-volume bots (like research) and your strongest model to the bot that needs the most judgment (the editor). Set up at least one connection now; you can add more anytime.

    Step 3: Turn on Bot Mode

    In Hermes v0.20.3 and later, Bot Mode is bundled and on by default — the old single-session list is replaced by a roster of named Bots down the side. If you're on an older build, update first. (Bot Mode is also available as a standalone, MIT-licensed desktop plugin if you ever need to add it manually.)

    The Hermes-Bot-Mode repo on GitHub: open-source (MIT), described as "a roster of named agents with their own chats, avatars, routines, and bot-to-bot messaging."
    The Hermes-Bot-Mode repo on GitHub: open-source (MIT), described as "a roster of named agents with their own chats, avatars, routines, and bot-to-bot messaging."

    Pro tip: think of the roster like a team directory. A clear, scannable roster (good names, distinct avatars) is what makes a multi-bot workflow feel manageable instead of chaotic — so it's worth setting up thoughtfully in the next steps.

    Step 4: Create your Researcher bot

    Add a new Bot and fill in each field deliberately — this is what makes it reusable rather than a throwaway chat:

  • Name: Researcher — short and role-descriptive, so @mentioning it later is obvious.
  • Role / persona: write a tight brief. For example: "You find and summarize authoritative sources. You always return bullet points with links. You never write final copy — you hand clean material to the writer." A persona that also says what the bot doesn't do is what prevents overlap later.
  • Pinned model: a capable, search-friendly model.
  • Skills: enable the web/search tools so it can actually go find things.
  • Memory: on — so it remembers your preferred sources and formatting across tasks.
  • Avatar: anything memorable; distinct avatars make the roster readable at a glance.
  • Pro tip: be specific about the output format in the persona ("bullet points with source links"). Downstream bots depend on a predictable hand-off, and a vague researcher poisons the whole chain.

    Step 5: Create the Writer and Editor bots

    Repeat Step 4 for two more specialists, keeping each persona narrow and non-overlapping:

  • Writer — persona: "You turn research bullets into a clear, structured draft in a professional-but-approachable tone. You work only from the sources the researcher provides; you don't invent facts." Pin a strong writing model.
  • Editor — persona: "You tighten grammar, clarity, and structure. You flag anything not supported by the sources and never add new claims. Your output is final-ready." Pin your best model here — the editor is the last line of defense, so it's worth the cost.
  • Pro tip: give each bot exactly one job and one voice. Two bots with overlapping skills will redo (and argue about) each other's work; three sharply-defined bots move in a clean line.

    Step 6: Assemble a room and run the hand-off

    Now the payoff. Create a shared room and add your three bots (keep rooms small — 2–4 bots is the sweet spot; the limit is 6, with up to three rounds of turns per message). Kick the chain off by @mentioning the Researcher and naming each hand-off explicitly:

    
    @Researcher find the 3 biggest developments in [your topic] this month.
    Give 2–3 authoritative sources each, as bullet points with links.
    Then @Writer, draft a 400-word brief from those bullets.
    Then @Editor, tighten it and flag anything not backed by a source.
    

    Because bots message each other by @mention, the work flows down the chain automatically. You'll watch it happen in the room: the Researcher posts sourced bullets, @Writer picks them up and drafts, @Editor cleans it and raises flags. Step in at any point — correct a bot, add a constraint, or stop the run — exactly as you would in a real team chat.

    Pro tip: the quality of the hand-off is in the instruction, not the wish. "@Writer take it from here" invites drift; "@Writer, use only the bullets above and keep every source link" keeps the chain honest.

    Step 7: Schedule it as a routine

    Bots can run scheduled routines, which turns your team from on-demand into always-on. Set the Researcher to wake up each morning and kick off the same chain, and you'll review the Editor's finished brief with your coffee instead of starting from a blank page.

    Pro tip: always route a scheduled chain to a human review step before anything irreversible (publishing, sending, deleting). Automation should draft; you should approve.

    3 Common Mistakes to Avoid


  • Treating a bot team as a sandbox. Bots have real system access and no extra safety layer. Never let an autonomous chain touch anything destructive — files, money, publishing — without a human approval step in the flow.

  • Overlapping roles. Two bots with the same skills produce redundant, conflicting work. Give each a single sharp specialty and a persona that also states what it does not do.

  • Vague hand-offs. "@Editor do your thing" invites drift and hallucination. Say exactly what to pass and what to preserve, so nothing is silently dropped or invented between bots.
  • Going Further

  • Lean on the memory. Because each bot persists, spend time refining its persona and let its memory accumulate your preferences — a well-trained "Editor" becomes an asset you reuse across dozens of projects.
  • Add more specialists. Once the research → write → edit chain feels solid, add a "Fact-Checker" bot before the editor, or a "Formatter" that outputs to your CMS. Keep each new bot narrow.
  • Mix models per bot. Use Bot Mode's per-bot model pinning to run cheap models for volume and a premium model only where judgment matters — real cost control without losing quality.
  • Explore rooms as workflows. Different rooms can encode different pipelines (a "content desk," a "research desk," a "support triage desk"), each with its own cast of bots.
  • Key Takeaways

  • Hermes Bot Mode turns throwaway chats into a durable, collaborating team of AI bots you own — free, open-source (MIT), running on the models and hardware you choose.
  • Bots hand off work via @mentions in shared rooms (2–6 bots, up to three rounds per message), so one person can operate what looks like a whole team.
  • Configure each bot narrowly — a distinct role, persona, pinned model, and memory — to prevent overlap and keep hand-offs clean.
  • It is not a sandbox. Every bot has real system access; keep a human on the destructive steps and supervise scheduled routines.
  • Start with 2–3 sharply-defined bots, get one clean hand-off working, then expand as you spot bottlenecks.
  • NousResearch/Hermes-Bot-Mode (GitHub)

    The open-source (MIT) Bot Mode plugin — a roster of named agents with their own chats, avatars, routines, and bot-to-bot messaging.

    github.com

    Sources: Hermes Agent docs · NousResearch/Hermes-Bot-Mode (GitHub) · Nous Research — Bot Mode announcement

    Learn AI, after work

    Track your progress, earn XP, and unlock more free tutorials in the AfterWork Bytes app.

    Open this tutorial in the app

    More AI tutorials