Hermes Buzz: messaging bridge for Hermes Agent

Starter kit for running Hermes Agent as a member of a Buzz community through buzz-acp and hermes-acp

What Hermes Buzz does

Hermes Buzz is configuration and onboarding only. It does not include Hermes or Buzz, and it ships no secrets, private hostnames or operator-specific settings. It supports two paths. In Buzz Desktop you pick Hermes Agent as the agent runtime, which runs the hermes-acp command. For an always-on agent on a laptop or VPS, buzz-acp starts hermes-acp over ACP stdio and handles mentions, queueing and gates.

The repository holds an onboarding script that writes a .env file, a doctor script that checks dependencies and configuration, a run script, prompt templates for system, team and heartbeat text, and example systemd and launchd units. Its security notes recommend keeping BUZZ_ACP_RESPOND_TO set to owner-only and naming an agent owner, and the README advises against putting secrets in unit files. It also says it is not a substitute for reviewing Hermes tool permissions or host hardening.

Key features

Headless path through buzz-acp and hermes-acp
Buzz Desktop path using the Hermes Agent runtime
Guided onboarding and doctor scripts
Prompt templates for system, team and heartbeat text
Example systemd and launchd units for always-on agents
Owner-only response default and per-channel filter example

When to use it

Adding a Hermes agent to a team's Buzz channels
Running an always-on Hermes agent on a VPS that answers @mentions
Onboarding teammates to a Hermes agent with a shared checklist

Who it is for: Teams that use Buzz and want a Hermes Agent as a participant in their channels.

How it fits with Hermes Agent

Built around Hermes Agent's ACP support. It uses the hermes-acp command to run Hermes as the agent runtime for Buzz.

How to install Hermes Buzz

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

git clone https://github.com/0xNyk/hermes-buzz.git
cd hermes-buzz
./scripts/onboard.sh
./scripts/doctor.sh

Requirements: A Buzz relay, buzz-acp and the buzz CLI on PATH, Hermes Agent with ACP support (hermes-acp), and model credentials configured in Hermes

Note: It contains configuration and onboarding only, so Hermes Agent and Buzz must be installed separately.

FAQ

What is Hermes Buzz?

Hermes Buzz is a starter kit for running Hermes Agent as a member of a Buzz community. It contains onboarding scripts, prompt templates and service examples, not a copy of Hermes or Buzz.

Does Hermes Buzz work with Hermes Agent?

Yes, it is built for Hermes Agent. Buzz Desktop has a Hermes Agent runtime that runs hermes-acp, and the headless mode uses the same binary through buzz-acp.

How do I install Hermes Buzz?

Clone the repository, run ./scripts/onboard.sh to write your .env file, fill in BUZZ_PRIVATE_KEY, BUZZ_RELAY_URL and BUZZ_ACP_AGENT_OWNER, then run ./scripts/doctor.sh and ./scripts/run.sh. Buzz tools must already be on your PATH.