ateymoori/pomelu

Pomelu is a free, open-source app for Hermes Agent, the self-hosted AI agent by Nous Research. Hermes runs on your own Mac, PC, home server or cloud machine; Pomelu connects to its gateway and puts every Hermes bot in your pocket. There is no Pomelu account and no tracking. Your chats go between your phone and your own agent; optional push passes a relay that cannot read them.

Watch the film

https://github.com/user-attachments/assets/d6deabe6-0c50-4f96-8567-aca11d544ada

_{Real app, real Hermes Agent, demo bots. iPhone Duo 3D model by Pikkme Studio (CC BY 4.0). Music: Dirty Thinkin' (Mixkit).}

Features

• One chat per bot, like a messenger. Every Hermes profile is a bot in the side menu; a new conversation starts in the same chat.
• Live answers in Markdown with code, tables, tool activity and the agent's plan while a task runs. Stop a turn at any time.
• Answer the agent: questions, approvals and secret input show up as cards in the chat and as notifications.
• Voice, photos, video and files both ways, plus a place from a map. Replies can be read aloud in the bot's own voice.
• Share from any app into a bot. Your bots sit in the share sheet and in the app icon's menu.
• Bot details: skills, tools, instructions, SOUL.md (editable) and scheduled cron jobs (pause, resume, run now, delete). Create, rename and delete bots like Hermes Desktop.
• Bot Screen: watch a bot work on its own Linux desktop, take over with touch, keyboard, paste and drag and drop, then hand it back. Needs a Linux gateway host with Bot Screen set up.
• Notifications for replies and questions. On Android the app can stay connected in the background.
• Private by design: no analytics, no ads, no tracking. The sign-in is kept in the Android Keystore or the iOS Keychain.
• Liquid Glass design (iOS 27 style), light and dark mode, Dynamic Type, VoiceOver and TalkBack.

Made for foldables and tablets

Galaxy Z Fold, Pixel Fold, iPhone Duo, iPad and Android tablets get a side pane with your bots next to the chat, a reading-width column, hardware keyboard shortcuts and right-click.

Bot Screen

Watch a bot work on its own Linux desktop, live in the app. When it needs you, tap Take over, do your part, and hand it back.

Get the app

The GitHub APK has a different signature from the Google Play build, so Android will not update one over the other. To switch, uninstall the one you have and sign in again. More at royan.se/pomelu.

Connect to your Hermes Agent

You need Hermes Agent 0.21.5 or newer on your own computer or server.

1. Set a username and password for the gateway in ~/.hermes/.env (make the secret with openssl rand -base64 32):

   HERMES_DASHBOARD_BASIC_AUTH_USERNAME=me
   HERMES_DASHBOARD_BASIC_AUTH_PASSWORD=a-strong-password
   HERMES_DASHBOARD_BASIC_AUTH_SECRET=paste-the-secret-here
   

2. Start the gateway and keep it running:

   hermes dashboard --host 0.0.0.0 --no-open
   

3. In Pomelu, open Settings, enter the address (for example http://192.168.1.20:9119 on the same Wi-Fi), sign in, then tap Test connection and Save and connect.

4. So that your bots can start a conversation, also while the app is closed (like on Telegram), use Pomelu 1.0.3 or newer and Hermes 0.22 or newer, and install the Pomelu plugin on the same computer, then restart Hermes:

   hermes plugins install ateymoori/pomelu-hermes-plugin --enable
   hermes pomelu setup
   

Away from home, use a private network such as Tailscale or put the gateway behind HTTPS. The same guide is in the app under Settings → "How to connect".

Build from source

Requirements: Flutter 3.47 (stable), the Android SDK (API 29+), and Xcode for iOS.

git clone https://github.com/ateymoori/pomelu.git
cd pomelu
flutter pub get
dart run build_runner build -d   # freezed, json, riverpod
flutter gen-l10n
flutter analyze && dart analyze && flutter test
flutter run

• Android: without android/key.properties the release build is debug-signed, which is fine for your own phone.
• iOS: Swift Package Manager only (no CocoaPods). Set your own team and bundle id in Xcode; the share extension needs an App Group with the same prefix.

A fork that you publish needs its own name, icon and app id: see TRADEMARKS.md.

How it works

Pomelu is a pure client. It speaks JSON-RPC over WebSocket to the Hermes gateway (/api/ws) and uses the dashboard's REST routes for bots, skills and cron jobs. It has no agent logic of its own.

Built with Flutter, Riverpod, go_router, freezed, dio, gpt_markdown, flutter_map and noVNC.

FAQ

Is Pomelu made by Nous Research? No. Pomelu is an unofficial, community-made client by Royan AB. It is not affiliated with or endorsed by Nous Research.

Do I need an account or a cloud service? No. Pomelu talks to the Hermes Agent gateway that you run; optional push passes a relay that cannot read it. Royan AB collects no data (privacy policy).

Which AI models does it support? All the models your Hermes Agent uses (for example Claude, GPT, Gemini, Llama or a local model). Pomelu shows what the agent sends.

Can I use it away from home? Yes, through a private network such as Tailscale, or with the gateway behind HTTPS.

Can my bots start a conversation, like on Telegram? Yes, with Pomelu 1.0.3 or newer and the Pomelu plugin for Hermes: a reminder or a scheduled job made in Pomelu then comes to the bot's chat, and the phone rings by push, also while the app is closed. The message is sealed on your Hermes with a key only your phone has; the Pomelu push relay that hands it to Apple or Google cannot read it.

Is it free? Yes. The app is free, with no ads and no in-app purchases, and the code is open source under Apache 2.0.

Contributing

Bug reports and pull requests are welcome. Read CONTRIBUTING.md before you start; new features start as an issue. Security problems: SECURITY.md.

License

The code is licensed under the Apache License 2.0. The name "Pomelu", the logo, the mascot, the bot characters, the promo films and the store art are not covered: see TRADEMARKS.md and NOTICE.

Made by Royan AB in Sweden · royan.se/pomelu. "Hermes Agent" and "Nous Research" belong to Nous Research.