Hermes Agents Team

What Hermes Agents Team does

Each agent is an independent Hermes profile with its own persona, skills, memory and tools. A web hub connects them: agents reach the hub through MCP, the hub reaches agents through ACP, and tasks flow through Hermes Kanban. The backend is Flask with Starlette and Uvicorn, storage is SQLite, and the frontend is plain HTML and JavaScript that shows agent conversations, terminal output and task flow in real time.

Management features include agent initialization, batch start, stop and restart, per-agent model configuration, team import and export (profiles, skills and an optional workspace), MCP server and skill installation, and SOUL.md editing. The README includes sample role descriptions for Leader, product, developer, test, design and operations agents, and a sample prompt that stages a to-do web project from a PRD through development to testing.

Key features

• Leader and Specialist agent roles with task splitting, review and summary
• Live web view of agent conversations, terminal output and tool calls
• Hermes Kanban board integration with auto-dispatch
• Per-agent model configuration
• Team import and export with profiles, skills and optional workspace
• MCP server and skill installation management, plus SOUL.md editing

When to use it

• Run a product, developer and test agent pipeline on one machine
• Watch several Hermes profiles work on a project from a single web page
• Move a configured agent team to another machine with export and import

Who it is for: Hermes Agent users comfortable with Python who want to coordinate several profiles as a team on a local machine.

How it fits with Hermes Agent

Built on Hermes Agent's profile, ACP and kanban features; each team member is a Hermes profile.

How to install Hermes Agents Team

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python run.py

Requirements: Linux or macOS (native Windows is not supported, use WSL2), Python 3.10+, Hermes Agent v0.12.0 or newer with profile, acp and kanban subcommands, and dispatch_in_gateway set to false under kanban in Hermes config.yaml.

Note: The README calls it a community experiment, not an official Nous Research project, advises running it only on a local machine or trusted network, and says maintenance is best effort.

FAQ