Hermes-Relay — Android

Hermes-Relay puts the Hermes Agent you already run on Android. Start with the standard Dashboard/Gateway connection for Chat, sessions, Manage, sign-in, and voice. Pair the encouraged Relay extension for Terminal/TUI, notifications, media, desktop tools, enhanced voice, Relay sessions, and optional Device Control.

Start here

Choose the path that matches your setup.

Recommended

Android + Relay

Connect the app, then pair Relay for the complete experience.

Follow the Quick Start →

Standard Hermes

Android only

Use Chat, sessions, Manage, sign-in, and standard voice without Relay.

Use Hermes without Relay →

Manual + advanced

Installation reference

Choose Play or Sideload, configure a host, or connect without QR.

Open Installation & Setup →

What the two connections do

• Connect mobile app adds the standard Hermes Dashboard/Gateway connection.
• Pair new device adds a separate, consent-scoped Relay grant.

The two QR codes are deliberately separate. You can use standard Hermes without Relay, and pairing Relay never replaces the upstream connection.

Connection Model

Phone (WS)       → Hermes dashboard (:9119)    [gateway chat with live thinking]
Phone (HTTP/SSE) → Hermes API Server (:8642)   [chat fallback, sessions, runs]
Phone (HTTP)     → Hermes dashboard (:9119)    [Manage + Vanilla Hermes voice]
Phone (WSS/HTTP) → Relay Server (:8767)        [Bridge Core, terminal, TUI, media, relay voice]

Chat prefers the dashboard gateway when Manage auth is ready and falls back to the Hermes API Server's SSE routes. The relay server handles Bridge Core, terminal, TUI, media, notification companion, relay sessions, and relay-backed voice routes. Sideload builds additionally expose Android Device Control routes.

Feature status

Feature	Status
Chat (Dashboard/Gateway primary, optional API fallback)	Complete
Session management	Complete
Profiles and personalities	Complete
Markdown + syntax highlighting	Complete
Reasoning display	Complete
Command palette + inline autocomplete	Complete
QR code pairing	Complete
Token tracking	Complete
Tool progress cards (Off/Compact/Detailed)	Complete
In-app analytics (Stats for Nerds)	Complete
Animated splash screen	Complete
Terminal/TUI relay	Beta
Bridge Core	Complete
Device Control	Beta (sideload track)
Hermes Chat + Voice Output	Complete
Realtime Agent	Experimental
Connection diagnostics	Complete

Quick Links

• Quick Start — Recommended Android + Relay setup
• Installation & Setup — Builds, manual setup, and fallbacks
• Chat Guide — Using the chat interface
• Supervised Mode — Planned parent-controlled, profile-pinned Android interface
• Sessions — Managing conversations
• Features — All features at a glance
• Architecture — How it works under the hood

Want Hermes to work on another computer?

The Desktop CLI pairs through the same Relay grant and gives Hermes consent-gated filesystem, terminal, process, clipboard, and screenshot tools on Windows, macOS, or Linux. The optional management UI is Windows-only.