Giton22 / herald
git clone https://github.com/Giton22/herald.git
v0.12.0 · 4d ago
Unofficial Android client for Hermes Agent.
+22
stars, 24h · #1,675
+~98
stars, 7 days · #2,167
+150
stars, 30 days · #4,977
150
★ total · +98% this week
23
forks · 31 open issues
Star history (as recorded here)
LanguageKotlin
LicenseMIT
Created2026-10-03 (20d ago)
Last pushtoday
Watchers3
OwnerUser
Links
- GitHub: github.com/Giton22/herald
- Releases · Issues · Hacker News mentions
README excerpt
# Herald **A native Android client for Hermes Agent.** Chat with your own agent, approve what it wants to do, and follow its work from your phone. Herald connects to the `hermes dashboard` you already run on a server, homelab, VPS or Tailnet, the same way Hermes Desktop's "Remote gateway" connection does. There is no Herald server and no account: the app talks to your gateway directly. > [!NOTE] > Herald is an independent project. It isn't made or endorsed by Nous Research. ## Contents - Features - Screenshots - Install - Requirements - Privacy - Community - Development - Releasing - License ## Features **Chat** - Streaming replies with Markdown, syntax-highlighted code, TeX math, reasoning and tool activity - One live status line for the task at work, with its plan and the running tool - Send while the agent works: steer the running reply, queue the next prompt, or stop and send - Select any part of a reply to comment on, explain or ask about on the side - Copy, edit, regenerate or branch from any message; every chat keeps its unsent draft - A prompt that may not have arrived can be checked, resent or edited; nothing resends by itself - Model, thinking level, fast mode and profile per chat, with starred and recent models - Photos, camera, files and PDFs; pictures and files the agent sends back - Dictation (on the device or through the gateway), hands-free voice chat and live voice calls **Control** - Approvals, questions, sudo, secret and password-manager prompts, also from a notification - Subagents, background processes and checkpoints: watch, stop and restore - A chat's cost, token use and what fills its context window **Organize** - Sessions sidebar with search, pins, projects, archive, export and Running / Needs you filters - Bots and rooms: chat with each bot, follow their exchanges, and @mention them in a room - Scheduled jobs: create, edit, pause and run them, and open each run as a chat - Capabilities: turn skills, toolsets and MCP servers on or off, and test a server - Config: change Hermes's own settings, or each bot's, by section or by search, or edit config.yaml - Insights: cost, sessions and tokens by day, and the models, tools and skills used most **Stay connected** - Notifications when a turn finishes or needs you, with inline approve, answer and reply - Optional end-to-end encrypted push from outside your network, without Google services - Several saved gateways, each kept signed in - An encrypted offline copy of recent chats, readable while the gateway can't be reached - App lock with fingerprint, face or screen lock The full feature list, and what's planned, is in the roadmap. ## Screenshots | A reply | At work | Subagents | |:---:|:---:|:---:| | | | | | **Delivery check** | **Bots** | **A room** | | | | | | **Voice chat** | **Model picker** | **Usage and context** | | | | | | **Background processes** | **Checkpoints** | **Insights** | | | | | | **A scheduled job** | **Capabilities** | **Connect** | | | | | All screenshots sh