Hermes Android is a Flutter client for the Hermes agent harness. It connects a phone or tablet to a Hermes Gateway API Server on the same local network, or over a private Tailscale network, and lets you browse sessions, open new chats, and send prompts to your Hermes sessions with streamed responses. The app is a thin client: every provider key and model setting stays on the Hermes host.
Against a current Hermes gateway the app speaks the Desktop Gateway JSON-RPC transport over one WebSocket session for text, images, and files, with approval, sudo and secret, clarification, reasoning, tool-activity, review, and subagent events rendered natively. Where the gateway advertises a turn-recovery contract, completed turns are recovered exactly once after the Android process is killed. Against older gateways the app falls back to the legacy transport and re-syncs server-side history on resume. Reverse-proxy path prefixes, private certificate authorities, and password-protected or proxied dashboards are supported per connection.
A workspace shell organizes the Hermes side of things from the phone: a Home pane with a needs-you digest, a Projects pane backed by the gateway's project RPCs, a Chats browser with filters and archive state, an Activity timeline of gateway turns, and session search that runs on-device, through the dashboard's full-text index, or through AI-assisted query rewriting on the server. Memory, cron jobs, skills, and model settings come from the Hermes dashboard API, so scheduled jobs can be listed, triggered, paused, and edited from the app.
Conversation tools include per-chat model and thinking-effort selection, up to ten sanitized attachments per message, copy and select text, read aloud, edit and resend, regenerate, branch, rename, export, voice dictation with optional spoken replies, and background Android notifications when a turn completes. Connections and preferences can be exported to an encrypted backup and restored on another device, and the interface ships in nine languages.
Features
- Hermes chat on Android: browse sessions, start chats, and send prompts to a Hermes Gateway API Server over Wi-Fi or Tailscale, with streamed tokens
- Desktop Gateway JSON-RPC transport: one WebSocket session for text, images, and files, with native handling of approvals, sudo and secret prompts, clarifications, reasoning, tool activity, reviews, and subagent status
- Durable turn recovery: completed gateway turns survive Android process kills when the gateway advertises the recovery contract, with a labeled legacy fallback otherwise
- Workspace shell: Home digest, Projects, Chats browser with filters and archive state, Activity timeline, and a More pane for cron, skills, memory, and settings
- Session search: on-device, dashboard full-text with matching excerpts, or AI-assisted query rewriting on the Hermes server, remembered per connection
- Dashboard integrations: memory, cron job management, skills browser, and model settings through the Hermes dashboard API, including password-protected and proxied dashboards
- Per-chat model and thinking effort: override the profile default for a single conversation
- Attachments: up to ten files per draft with metadata-sanitized images, ordered upload, reordering, and per-file retry
- Conversation actions: copy and select, read aloud, stop, edit and resend, regenerate, branch, rename, search, export, and delete
- Voice: microphone dictation staged before send, with optional text-to-speech replies
- Background notifications: Android notifications for completed and failed turns, approvals, clarifications, and plugin events while the app is backgrounded
- Encrypted backup and restore: all connections and preferences exported to one PBKDF2 and AES-256-GCM protected file, importable in merge or replace mode
