Hermes-Relay

Axiom-Labs

About this app

Hermes-Relay is the native Android companion for the Hermes agent you run. Chat, talk hands-free, continue sessions, and manage models, keys, skills, profiles, and automations from your phone.

It is not a hosted AI service. Your Hermes agent stays on infrastructure you control, and the app talks only to instances you configure.

QUICK START

1. Start the Hermes Dashboard/Gateway on your computer or home server with hermes dashboard.
2. Install Hermes-Relay from Google Play.
3. For the recommended full setup, install the Hermes-Relay plugin on the host and refresh the Web Dashboard. A Relay page will appear.
4. Scan Connect mobile app from Android Connect. Then scan Pair new device from Android Settings > Connections.

The QR codes are separate on purpose. Connect mobile app adds the standard Dashboard/Gateway connection. Pair new device grants a time-limited Hermes-Relay session for the additional capabilities you approve.

Standard Hermes without the plugin is supported. Choose Find Hermes on LAN or enter the Dashboard address you open in a browser, normally http://:9119. Pair the Hermes-Relay plugin later when you want the full experience.

HOW IT WORKS

Chat, sessions, Manage, sign-in, and standard voice use the unmodified Hermes Dashboard/Gateway. The separate Hermes API server is an optional fallback for advanced or headless setups; it is not required for the normal Android connection.

The encouraged Hermes-Relay plugin adds Terminal/TUI, notifications, media handoff, enhanced voice, Relay sessions, desktop-tool handoff, and time-limited per-feature grants. When upstream Hermes provides a compatible capability, Hermes-Relay prefers it instead of duplicating it.

GOOGLE PLAY AND SIDELOAD

The Google Play build includes Chat, voice, sessions, Manage, profiles, notifications, media, and Terminal/TUI when the Hermes-Relay plugin is paired.

Google Play does not include Android Device Control. It cannot read the phone screen, tap, type, swipe, take device screenshots, send SMS, place calls, or access contacts or location.

Device Control is available only in the signed Sideload build on this project's GitHub Releases. It requires the Sideload app, a paired Hermes-Relay plugin, explicit Android accessibility permission, and the app's safety controls.

FEATURES

- Streaming Chat with reasoning, markdown, tool progress, attachments, mid-turn steering, edit-and-resend, and searchable commands.
- Manage models and provider keys, edit profiles, and browse, install, or update skills through the Hermes Dashboard.
- Hands-free voice through your server's speech providers. Hermes-Relay pairing adds per-profile voices and an experimental realtime engine.
- Create, switch, search, rename, pin, archive, and continue sessions.
- Connect multiple Hermes servers and switch in one tap; add LAN, Tailscale, or public routes.
- Pair the Hermes-Relay plugin for Terminal/TUI, notifications, media, enhanced voice, Relay sessions, and per-feature grants.
- Inspect connection readiness, routes, response timing, token usage, and stream health without exposing credentials.

SECURITY AND PRIVACY

- Dashboard sessions and Hermes-Relay tokens use encrypted Android storage.
- Cleartext is limited to trusted local-network setups. Use a VPN or HTTPS remotely.
- No telemetry, ads, tracking, or third-party analytics SDKs.
- Notification and microphone access are optional and user-controlled.
- App traffic goes only to servers you configure.

REQUIREMENTS

- Android 8.0 or later.
- A reachable Hermes Dashboard/Gateway.
- The Hermes-Relay plugin is encouraged for the complete experience but never blocks standard Hermes.
- Network access through a local network, VPN, or operator-managed internet route.

OPEN SOURCE

Hermes-Relay is MIT licensed. Source, setup guides, downloads, and issue tracking are on GitHub.

This community project is not affiliated with or endorsed by NousResearch.

Ratings and reviews

it works most of the time. I had many issues just getting it connected initially, but there have been several updates since then. Still, I never did get all the functions working, never had TTS working right, and often I'd find my local LLM being completely braindead using the app, but perfectly fine if I accessed it via the web Dashboard. kinda disappointing, and that's why I stopped using this app.

The keyboard needs to default to enter =newline, it is genuinely infuriating to have it default to send, or it'd be a 5/5 app. Everything else is on point, :chefkiss: -edit: everything is fixed, par excellence. beautiful work!

This app is legit and, in my opinion, is what has been missing for hermes. Telegram works okay but doesn't facilitate great session management. The one piece of feedback I can offer is working to streamline setup more. The docs say to scan a QR code it I don't know where I'm supposed to get that in the dashboard. Eventually, my Hermes config was automatically detected but it took several minutes for that to happen. Great app, thanks for the build!

What’s new

v1.16.0 - Safer startup, connections, and activity

Gateway chat now opens reliably on a cold launch. Saved Dashboard sign-ins stay bound to the correct connection, pasted credentials ignore accidental line breaks, and network changes no longer race the route cache. Bot Mode supports duplicate profile names across gateways, while delegated work, session setup, attachment errors, and feedback remain visible and easier to review.