docs: make Android native app the primary target

This commit is contained in:
Hermes Agent
2026-07-09 03:50:27 +00:00
parent 2cd4730324
commit deec0c7fa3
6 changed files with 166 additions and 80 deletions
+13 -10
View File
@@ -1,6 +1,6 @@
# Hermes Mobile
Native-feeling Android-first PWA and companion server for [Hermes Agent](https://github.com/NousResearch/hermes-agent).
Native Android app, installable PWA fallback, and companion server for [Hermes Agent](https://github.com/NousResearch/hermes-agent).
Hermes Mobile is not a generic LLM chat UI. It is a self-hosted, Hermes-native control surface designed for phone use: prompt by text or voice, upload files, watch tool calls live, approve actions, manage cron jobs, and get notified when long-running agent work is done.
@@ -22,11 +22,11 @@ Planning scaffold only. No production code yet.
## Planned Components
```text
Android / mobile browser
Android app (Capacitor native shell)
|
| HTTPS + WebSocket/SSE + Web Push
| HTTPS + WebSocket/SSE + native push
v
Hermes Mobile App (PWA / later Capacitor)
Hermes Mobile App (native Android first, PWA fallback)
|
v
Hermes Companion Server
@@ -41,9 +41,11 @@ Hermes Companion Server
## MVP Feature Set
1. Mobile-first app shell
- Installable PWA
- Android-style bottom navigation
1. Native Android-first app shell
- Capacitor Android wrapper around the shared web UI
- APK/release build installable directly on Android
- PWA/web build retained as fallback and fast dev target
- Native-style bottom navigation, status bar, splash screen, haptics, push, share target later
- Offline-friendly shell
- Dark, playful visual system inspired by happy.engineering / Happy app
@@ -103,11 +105,12 @@ Hermes Companion Server
Frontend:
- TypeScript
- React + Vite or Next.js static/PWA mode
- React + Vite
- Tailwind CSS
- Zustand or TanStack Query for client state
- Service Worker + Web Push
- Capacitor later, only if PWA limitations matter
- Capacitor Android from the start for genuine phone-app feel
- PWA/service-worker build kept as fallback and for desktop/LAN access
- Native plugins: Push Notifications, Haptics, Filesystem/Share, Status Bar, Splash Screen
Companion server:
- TypeScript Node.js initially, because file uploads, WebSocket/SSE, install scripts, and PM2/systemd are straightforward