Hermes Android

Native Android app for Hermes WebUI — the browser-based Hermes AI Agent interface, packaged as a native app with foreground keepalive.

Features

• Fullscreen WebView — loads your Hermes WebUI server
• Foreground Service — persistent notification keeps the connection alive when backgrounded
• 30s Health Pings — prevents server-side session timeout
• Auto-Reconnect — detects stale connection on resume and reloads
• Configurable Server URL — point at any Hermes WebUI instance
• JavaScript Bridge — exposes HermesNative for TTS, vibration, toasts from the web app
• Settings UI — gear icon FAB in top-right corner
• Wireless ADB Install — sideload via developer options pairing

Building

cd hermes-android
export ANDROID_HOME=/path/to/android-sdk
./gradlew assembleRelease
# APK at app/build/outputs/apk/release/app-release.apk

Requirements

• Android 8.0+ (API 26)
• Hermes WebUI server running on your network (default: http://10.0.1.49:8787)

Install

# Wireless ADB (recommended)
adb pair <phone-ip>:<port> <code>
adb -s <transport-id> install app-release.apk

License

MIT