bonzi/hermes-mobile
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

build: establish Android beta packaging

Browse Source
This commit is contained in:
Hermes Agent
2026-07-24 15:12:49 +00:00
parent b1bc66122b
commit 3b883bd534
9 changed files with 156 additions and 42 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+12 -24
View File
@@ -1,16 +1,17 @@
# Hermes Mobile
Android-first mobile control surface and local companion server for [Hermes Agent](https://github.com/NousResearch/hermes-agent).
Android-first native client for a remote [Hermes Agent](https://github.com/NousResearch/hermes-agent) gateway/API server, with a legacy local companion retained for compatibility.
Hermes Mobile is a self-hosted phone UI for running Hermes from Android: chat prompts, browse/edit workspace files, run terminal commands, and check companion/Hermes status over a simple HTTP API.
The current beta path is a Kotlin/Jetpack Compose thin client that connects directly to an upstream Hermes gateway. Hermes remains authoritative for authentication, sessions, streaming, tools, and backend behavior.
## What Works Now
## Current Android Beta
- Vite React mobile app with Chat, Files, Terminal, Status, and Settings screens.
- Capacitor configuration and scripts for generating/building an Android APK.
- Fastify companion server with bearer-token auth and safe workspace-root file/terminal access.
- Local setup command that generates and persists an access key.
- HTTP API communication between the mobile app and companion server.
- Native Kotlin/Compose chat, session, settings, adaptive layout, and accessibility foundations.
- Direct HTTPS gateway configuration with bearer/no-auth support and local-first routing.
- Capability-gated session streaming and tool lifecycle output.
- Semantic Android beta metadata at `v0.1.0-beta.1`.
Build and clean-install instructions are in [Android Beta Build and Install](docs/ANDROID_BETA_BUILD.md). Device installation and the release criteria remain unverified until recorded on a real device or emulator.
## Monorepo
@@ -75,26 +76,13 @@ Tap **Test connection** to validate the server and key.
## Android APK Build
Install Android Studio/SDK/JDK, then generate the native Android project and build a debug APK:
Build the native direct-gateway client without Capacitor synchronization:
```bash
npm run cap:add:android --workspace @hermes-mobile/mobile
npm run android:build:debug --workspace @hermes-mobile/mobile
npm run android:build:debug
```
APK output:
```text
apps/mobile/android/app/build/outputs/apk/debug/app-debug.apk
```
For later rebuilds after the native project exists:
```bash
npm run cap:sync --workspace @hermes-mobile/mobile
cd apps/mobile/android
./gradlew assembleDebug
```
See [Android Beta Build and Install](docs/ANDROID_BETA_BUILD.md) for prerequisites, the versioned APK path, package checks, clean installation, direct-gateway setup, and known limitations.
## Companion API