hermes-multi-user

A Hermes Agent skill for setting up and managing multiple user instances on a single machine.

Run separate agents for family members, coworkers, or different personas — each with their own personality, memory, conversation history, and platform connections (WhatsApp, Slack, Telegram).

Install

hermes skills install ajmeese7/hermes-multi-user-skill/hermes-multi-user --force

Why --force? The built-in security scanner flags this skill as dangerous because it references .env files, .bashrc, and systemd services — which is exactly what a multi-user setup skill needs to do. Review the SKILL.md yourself before installing if you'd like to verify there's nothing malicious.

What it does

This skill teaches your Hermes agent how to:

• Create isolated HERMES_HOME directories for additional users
• Set up systemd services so each instance runs independently
• Configure separate WhatsApp/Slack/Telegram connections per user
• Docker-sandbox secondary agents for security
• Version-control configs while excluding secrets and bundled data
• Detect custom vs bundled skills for clean backups

Usage

Once installed, just ask your agent:

"Set up a new Hermes instance for my wife Alice on WhatsApp"

"Help me version-control my multi-agent configs"

The agent will follow the skill's step-by-step guide, adapting paths and settings to your system.

Architecture

~/.hermes/              # Your agent (primary)
~/.hermes-alice/        # Alice's agent (separate everything)
  config.yaml           # Her settings
  SOUL.md               # Her personality
  .env                  # API keys
  memory/               # Her memory
  sessions/             # Her conversations
  skills/               # Her skills
  whatsapp/session/     # Her WhatsApp connection

All instances share the same hermes-agent codebase but are completely isolated in data and behavior.

Blog Post

For a full walkthrough of how this was built, see: How I Set Up Multi-User AI Agents with Hermes (And You Can Too)

License

MIT