NordRelay: messaging bridge for Hermes Agent

Bridge that connects coding agents including Hermes to Telegram, Discord, Slack, Matrix and a WebUI

What NordRelay does

NordRelay lets you drive coding agents from chat apps and a browser dashboard. Each Telegram chat or topic, Discord channel or thread, Slack channel, Matrix room, WebUI view and peer node gets its own independent session. Replies stream back with typing and status indicators and tool activity. You can send files, photos and voice, queue prompts, retry or stop a run, and collect generated artifacts.

Access is controlled by NordRelay users and groups, linked chat accounts and registered channels, and the first WebUI start creates the first admin. Sessions can optionally use isolated Git worktrees so several agents can work on one repository without seeing each other's unfinished changes. Peer nodes allow multi-host control. Setup is interactive with nordrelay init, nordrelay doctor checks it, and runtime config is written to ~/.nordrelay/nordrelay.env. The WebUI usually runs at http://127.0.0.1:31878/. Node.js 22 or newer is required.

Key features

Independent sessions per Telegram chat, Discord channel, Slack thread, Matrix room and WebUI
Streaming replies with tool activity, queues, retry and stop
File, photo, voice and generated artifact workflows
Users, groups and linked accounts controlling every dashboard and chat action
Optional isolated Git worktree sessions per agent
Peer nodes for multi-host control and a nordrelay doctor command

When to use it

Sending a task to a Hermes session from a phone through Telegram
Letting a team use shared agents from Slack with per-user permissions
Running several agent sessions on one repository in separate worktrees

Who it is for: Developers who run coding agents on a server or workstation and want secure remote access from chat apps.

How it fits with Hermes Agent

Supports Hermes as one of five agent backends, together with Codex, Pi, OpenClaw and Claude Code.

How to install NordRelay

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

npm install -g @nordbyte/nordrelay
nordrelay init
nordrelay doctor
nordrelay start

Requirements: Node.js 22 or newer, at least one supported coding agent installed and authenticated, and a bot or app token for any chat adapter you enable

FAQ

What is NordRelay?

NordRelay is a secure remote control plane for coding agents. It connects agent sessions to Telegram, Discord, Slack, Matrix, a WebUI and trusted peer nodes.

Does NordRelay work with Hermes Agent?

Yes. The README lists Hermes among the supported agents, together with Codex, Pi, OpenClaw and Claude Code.

How do I install NordRelay?

Run npm install -g @nordbyte/nordrelay, then nordrelay init, nordrelay doctor and nordrelay start. pnpm and Yarn can install the same package.