Hermes XBot

What Hermes XBot does

Hermes XBot connects an Android phone to a Hermes server through REST and server-sent-event APIs. A teammate hub lets you choose which agent to chat with (Default, Engineering, Research, Outreach or DevOps), each with an auto-generated avatar and an online or idle badge. Replies stream with automatic resume and replay, and tool activity appears as collapsible cards showing terminal output, Git diffs, browser previews and Python traces. Dangerous commands and clarifying questions arrive as one-tap approval prompts.

Mobile features include push-to-talk voice notes with server transcription and TTS playback, an Android share target for URLs, text and photos, and a foreground sync service that keeps streaming tasks running with the screen locked. A Room database caches sessions, messages and projects offline, and credentials are held in a hardware-backed encrypted keystore. Panels cover a Mnemosyne memory viewer, a scheduled cron manager and a Kanban mission board.

Key features

• Teammate hub for choosing between Default, Engineering, Research, Outreach and DevOps agents
• Streamed replies with collapsible tool activity cards
• One-tap approvals for dangerous commands and clarifying questions
• Push-to-talk voice notes with transcription and TTS playback
• Android share target and offline caching with a Room database
• Panels for Mnemosyne memory, cron tasks and a Kanban board

When to use it

• Chatting with a Hermes server from an Android phone
• Approving agent commands while away from the desk
• Sharing links or photos from Chrome or a file manager straight into a Hermes session

Who it is for: Hermes Agent users with an Android phone who want a native mobile front end for their server.

How it fits with Hermes Agent

Built for Hermes Agent and hermes-webui, connecting to the Hermes dashboard server by its address, such as a domain or a Tailscale IP.

How to install Hermes XBot

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

hermes dashboard --host 0.0.0.0 --port 8787
adb install release/HermesXBot-latest.apk

Requirements: A reachable Hermes server running the dashboard, and an Android device

Note: It is built on the open-source Hermex project by Uzair Ansar and the hermex-android-port, which the README credits as upstream.

FAQ