Kyllene

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.

Kyllene 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 Kyllene server and no account: the app talks to your gateway directly.

[!NOTE] Kyllene is an independent project. It isn't made or endorsed by Nous Research.

[!TIP] Kyllene was called Herald until this release. It's the same app: an update installs over Herald and keeps your sign-in, chats and settings.

Contents

• Features
• Screenshots
• Install
• Requirements
• Privacy
• Community
• Support Herald
• 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

All screenshots show sample data, not a real gateway.

Install

1. On your Android phone (Android 8.0 or newer), download the APK from the latest release. For almost every phone that is the arm64-v8a build; the release notes say which fits other devices.
2. Open it, and allow installing from your browser when Android asks.
3. Kyllene tells you when a new release is out. Install it over the old one; your sign-in and settings stay.

Requirements

If something doesn't connect, Settings → Check connection tests the server, the sign-in and the live connection one at a time and says what to fix.

Privacy

• Kyllene talks only to your gateway, with these exceptions, each under your control:
  • it asks GitHub whether a newer release exists (can be turned off in Settings);
  • it loads pictures embedded in replies when you tap them;
  • webpage previews automatically fetch up to three linked pages per completed reply and their thumbnails, without gateway cookies and never from addresses on your own networks, only if you allow it;
  • if you install the push plugin, notifications from outside your network go through ntfy, end-to-end encrypted and signed.
• Your sign-in and the offline copy of your chats are encrypted with a key held in the Android Keystore. App data is excluded from backups.
• No analytics, no tracking.
• Phone tools are off until you switch each one on in Settings → Phone tools. What a tool reads (your location, calendar, contacts, or steps, sleep and heart rate from Health Connect) goes only to your gateway's agent, in the chat that asked, when the agent calls it. Kyllene only reads health data, never writes it, and keeps none of it.

Community

Join the Discord to get help, share your setup, suggest features and hear about new releases first. In the app, it's under Settings → About → Join the Discord.

Found a bug? Open an issue here or post it in the server's #bug-reports.

Support Herald

Herald is free and open source. If it's useful to you, you can support its development through GitHub Sponsors or Ko-fi.

Development

Want to contribute? Read CONTRIBUTING.md first.

Requirements: JetBrains Runtime 25 (Android Studio's bundled JBR is one; Gradle downloads it when none is found) and the Android SDK with API 37. For inline widgets and plugin pages in the desktop app, use the JBR build with JCEF.

Build, test and install a debug build:

./gradlew :androidApp:assembleDebug

./gradlew :shared:core:testAndroidHostTest :shared:ui:testAndroidHostTest

./gradlew :androidApp:installDebug

Run the experimental desktop app, or package it (an MSI on Windows, a DMG on macOS, a DEB on Linux):

./gradlew :desktopApp:run

./gradlew :desktopApp:packageReleaseDistributionForCurrentOS

The release package goes through ProGuard, which