Hermes channel plugin

Want to message the Hermes coding agent from Relay through the CLI bridge instead? See Hermes Agent.

Give a Hermes Agent you already run its own Relay channel with hermes-relay-plugin. Your Hermes gets an agent profile, a handle, and a thread in someone’s message list, and it answers there. The plugin is pure Python with no runtime dependencies beyond what Hermes ships. It receives by long-polling GET /v1/events, so there is no webhook server, no public URL, and no signing secret; a Hermes on a laptop behind NAT works like one on a server.

Install

Clone into the Hermes plugins directory

git clone https://github.com/relaymessenger/hermes-relay-plugin \
  ~/.hermes/plugins/relay
hermes plugins enable relayapp-platform

The platform id is relayapp, not relay: Hermes ships a built-in Platform.RELAY for its own connector, so this plugin takes the next available name.

Set the Agent Token

Create an agent in the Relay app and copy the Agent Token; Relay shows it once. See Create and connect an agent. Then put it in ~/.hermes/.env:

RELAY_AGENT_TOKEN=rly_live_...

hermes config sets the same variables through the config UI.

Start the gateway

hermes gateway start

The agent is live. Message it in the Relay app and it answers.

Configuration

Variable	Required	Meaning
`RELAY_AGENT_TOKEN`	✅	Agent Token (`rly_live_...`), shown once at creation
`RELAY_ALLOWED_USERS`	❌	Comma-separated Relay user ids allowed in, besides the owner
`RELAY_ALLOW_ALL_USERS`	❌	Let anyone who can reach the agent talk to it. Default `false`
`RELAY_REPLY_TO_MODE`	❌	`off`, `first`, `all`, or `auto`. Default `auto`

By default only the agent’s owner is answered: the adapter reads agent.owner_user_id from GET /v1/agents/me and drops every other sender before the text reaches the model. A Hermes with shell and file tools is not a public endpoint, so widening access with RELAY_ALLOWED_USERS or RELAY_ALLOW_ALL_USERS is a deliberate decision.

Next steps

Hermes Agent to bridge Hermes as a coding engine over ACP
Long polling for the transport this plugin uses
Create and connect an agent for tokens and distribution
Integration troubleshooting for the symptoms every integration shares

Start here

Send

Receive

Connect what you already run

Reference

Relay for Business

About Relay

Hermes channel plugin

Install

Configuration

Next steps

​Install

​Configuration

​Next steps

Install

Configuration

Next steps