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, voice, and inbound files. Pair the encouraged Relay extension for Terminal/TUI, notifications, desktop tools, enhanced voice, Relay sessions, optional Device Control, and media compatibility or metadata.

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)   [Direct API compatibility, sessions, runs]
Phone (HTTP)     → Hermes dashboard (:9119)    [Manage + Voice + inbound files]
Phone (WSS/HTTP) → Relay Server (:8767)        [Bridge Core, terminal, TUI, relay voice + media enhancements]

Standard Chat remains on the Dashboard Gateway and asks for sign-in or retry when unavailable. API-only and explicitly selected Direct API chats use the Hermes API Server's SSE routes. Authenticated Dashboard file routes handle ordinary inbound media. The Relay server handles Bridge Core, terminal, TUI, notification companion, Relay sessions, Relay-backed voice, and additive media compatibility. Sideload builds additionally expose Android Device Control routes.

Feature status

Feature	Status
Chat (Gateway standard, explicit Direct API compatibility)	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.