An Android companion for Hermes Agent. Hermes runs on your Mac; this app provides a polished phone interface that connects directly to your gateway.
This project is intentionally transparent about its origin: it was initially vibe-coded with help from Hermes Agent and is now being cleaned up as a normal, community-contributable open-source project. The maintainer is not a professional programmer, so clear explanations and patient pull requests are welcome.
Android phone → Tailscale → Hermes gateway on your Mac
The repository contains the client only. It does not contain Hermes, a gateway, API keys, access tokens, or a hosted proxy.
The app can connect to a local Hermes gateway, browse sessions, send chat messages, stream responses, select models, and attach images/files. It is still in active development and should be treated as an experimental client.
Requirements:
- Node.js 20+ and npm
- Android Studio / Android SDK for APK builds
- Java 21 for the Android Gradle build
- A Hermes gateway for end-to-end testing
npm install
npm run devFor a local Android debug build:
npm run build
npx cap sync android
(cd android && ./gradlew assembleDebug --no-daemon)The complete interface is bundled into the APK. The Mac only needs to run the
Hermes gateway; no frontend development server is required after installation.
The APK is written to android/app/build/outputs/apk/debug/.
Install Tailscale on both the Mac running Hermes and the Android phone. Expose
the local gateway with Tailscale Serve, then enter its HTTPS URL and gateway
access token in the app's Settings. Plain HTTP gateway URLs are rejected so the
token is never transmitted without encryption. On Android, the token is encrypted
with a non-exportable Android Keystore key; it is never written to WebView
localStorage, and app-data backups are disabled.
Do not copy the maintainer's hostname, token, .env file, or screenshots with
private connection details into an issue or pull request.
See CONTRIBUTING.md before opening a pull request. Please start with an issue for larger changes. Every contribution is reviewed and built before it is merged.
See SECURITY.md. If you think a credential was exposed, revoke it immediately rather than merely deleting the file from the latest commit.
MIT
0 comments
log in to comment.