Hermes-Relay plugin
A Hermes Agent plugin with a Relay server: chat, voice and a terminal on Android, plus a desktop CLI for the agent's tools
- 442 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The desktop CLI gives the agent a terminal, file read and write, screenshots and the clipboard on a paired machine
- In the sideload build the agent reads the phone screen, taps, types and sends SMS
- The Relay server accepts connections to the agent: keep it on a trusted network behind consent grants
Install
- Works in
Manual install
hermes plugins install Codename-11/hermes-relay/plugin --enableNeeds Python 3.11 and a current hermes-agent with the dashboard enabled. The app installs separately from Google Play or an APK from the releases page.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The desktop CLI gives the agent a terminal, file read and write, screenshots and the clipboard on a paired machine
- In the sideload build the agent reads the phone screen, taps, types and sends SMS
- The Relay server accepts connections to the agent: keep it on a trusted network behind consent grants
This is third-party code. Review the repository files before installing.
What it does
Hermes-Relay puts your Hermes agent on the devices you carry. A plugin for Hermes Agent starts a Relay server on port 8767, and the Hermes-Relay Android app and the `hermes-relay` desktop CLI connect to it. The agent's brain stays on your machine; the phone and the computer are channels to it. The plugin adds what plain Hermes lacks: a terminal and TUI on the phone, notifications, desktop tools, enhanced voice, Relay sessions, page drafts with approval and, optionally, Device Control. Chat, model and key management, voice and inbound files work without the plugin through the Hermes dashboard and gateway. The desktop CLI (beta) gives the agent hands on a paired machine: `read_file`, `write_file`, `terminal`, `search_files`, `screenshot`, `clipboard`, `open_in_editor` and more. They run behind a one-time consent gate, with interactive diff approval for patches and a `--no-tools` kill switch. One invite creates the pair: `hermes pair` renders a QR code in the terminal, and `hermes-relay pair --pair-qr … --grant-tools` connects the computer. In the sideload build the agent can also read the phone screen and tap on it. Banking and two-factor apps are blocked by default, and destructive verbs need confirmation.
Who it is for. Hermes Agent users who want to talk to the agent from a phone and give it access to their machines under consent controls.
Good fit when
- Your Hermes agent lives at home and you want chat and voice on the go: the connection runs over the local network or Tailscale between your own devices
- You want the agent's terminal on the phone, and the agent should triage and summarize incoming notifications
- The agent reads and edits files on a second machine of yours, and you approve each patch in a diff
- Home and work Hermes servers switch in the app with one tap
Not a fit when
- You only need chat with Hermes: it works without the plugin through the standard dashboard
- The Relay server would have to be exposed beyond a trusted network: read the remote-access guide first
- You need a client for iPhone: the app targets Android 8.0 and newer
Example request
Install the Hermes-Relay plugin and show me the pairing invite for my Android phoneLimitations
- The app needs Android 8.0 or newer, the plugin needs Python 3.11 and a current hermes-agent with the dashboard enabled. The desktop CLI is in beta and its binaries are unsigned, so SmartScreen and Gatekeeper will warn.
- Device Control, SMS, contacts and dialing exist only in the sideload build (the `-sideload-release.apk` file), not in Google Play.
- The `--no-ssl` flag suits a trusted local network. Open Relay wider only after reading the remote-access guide.
- Some features work without the plugin through the Hermes dashboard, but the terminal, notifications and desktop tools require the plugin.
How to disable. Disable the plugin in Hermes Agent and revoke the paired devices in the Relay panel. The Relay server uninstall steps are in the server reference on the project site. On a computer the CLI is removed like any app, and Windows has an emergency stop button.
FAQ
How do I install the Hermes-Relay plugin in Hermes Agent?
Run `hermes plugins install Codename-11/hermes-relay/plugin --enable`, then `hermes relay doctor` and `hermes relay start --no-ssl`. After refreshing the dashboard, open the Relay section, press Pair new device and scan the QR code in the app.
Do I need the plugin to talk to Hermes from a phone?
No. Chat, model and key management, voice and inbound files work with plain Hermes through the dashboard after one sign-in. The plugin adds the terminal, notifications, desktop tools and enhanced voice.
What can the agent do on the phone?
In the Google Play build the agent works as a chat and voice assistant. In the sideload build it also reads the screen, taps, types, takes screenshots and sends SMS, while banking apps are blocked by default.
How do I connect the desktop CLI?
Install the CLI with the installer from the releases page, then run `hermes-relay pair --remote ws://<host>:8767`. The invite from the dashboard connects the computer with the `--grant-tools` flag, and `hermes-relay daemon start` launches the background tool router.
Is it safe to expose Relay to the internet?
The project advises starting on a trusted local network and using Tailscale between your own devices away from home. Before opening Relay wider, read the remote-access guide at hermes-relay.dev.
Discussion
No questions or reviews yet.
Related
PluginsA self-improving agent from Nous Research with a TUI, messaging gateway, cron jobs and skills it writes itself
A pack of 19 plugins for Hermes Desktop: provider quotas, an iteration meter, a memory review queue, session management and RSS.
A Hermes Agent plugin for live WhatsApp voice calls: you call the bot or it calls you, with speech handled by Gemini Live.
Official Hermes Agent plugins: Home Assistant, Spotify, Blender, Snyk, Langfuse, sandboxes and importers for other agents
Alice Voice for Hermes
hermes-alice-voice
Voice input through Yandex Alice for Hermes Agent: a private skill sends recognized text to a personal Telegram dialog. Experimental, for a single operator
A pack of practical skills for Hermes Agent: notes, trips, code security, browser automation and interface themes.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Hermes-Relay (this card) | no | 442 | |
| Telegram Dashboard for Hermes | no | 7 | agent status in one pinned Telegram message, with no app and no terminal |
| Hermes Field Kit | no | 127 | a skill set for diagnosing and migrating Hermes Agent, with no phone client |
README in short
The page says the project consists of an Android app and a desktop CLI for Hermes Agent, and walks through installing the app, running the Hermes dashboard and connecting. It then covers Android features, the CLI and a diagram of the links between phone, dashboard, API and Relay.