Hermes-Agent Mobile
amirghm/hermes-agent-mobile
Installer that runs Hermes Agent on a phone: Android through Termux, iOS through iSH with limits
Hermes-Agent Mobile is an installer project that runs Hermes Agent directly on a phone, on Android through Termux and on iOS through iSH. The Android path sets up Debian, Firefox and Hermes with one command, so the agent needs only your API key, with no laptop or server.
What Hermes-Agent Mobile does
Hermes-Agent Mobile brings Hermes Agent to Android (Termux) and iOS (iSH) so the agent runs on the phone itself, with API calls going straight from the phone to the model provider. On Android a single script installs Debian, Firefox and Hermes, then offers a quick setup that takes an OpenRouter API key and a Telegram bot token. The README lists a Telegram gateway with group support, speech-to-text through Speechmatics, text-to-speech with Edge TTS, persistent memory, skills, cron jobs, file operations, Brave web search, a headless Firefox browser through Playwright, image generation through APIs and subagent delegation as working on Termux.
Several agent personas can run at once, for example seven bots in one Telegram group, each with its own role. A guide covers keeping Hermes alive in the background on Android. The iOS path is narrower: iSH supports chat in CLI mode, memory, skills, file operations and web search through API calls, but not the Telegram gateway, voice or cron jobs, because iSH lacks subprocess syscalls.
Key features
- One-command Android install through Termux that sets up Debian, Firefox and Hermes
- Telegram gateway with group chats on Android
- Voice input and output on Termux through Speechmatics and Edge TTS
- Multiple agent personas running at the same time
- Guide for keeping Hermes running in the background on Android
- iOS support in iSH limited to CLI mode, memory, skills, file operations and web search
When to use it
- Running a personal Hermes assistant from a phone without a laptop or server
- Setting up a team of role-based Hermes bots in a Telegram group
- Scheduling monitoring jobs with cron on an always-on Android phone
Who it is for: Hermes Agent users who want the agent on an Android or iOS phone, using their own model provider API key.
How it fits with Hermes Agent
Built to run Hermes Agent itself on mobile, packaging its install for Termux on Android and iSH on iOS.
How to install Hermes-Agent Mobile
These commands are copied from the project's README. Check the repository for the latest steps before you run them.
bash <(curl -fsSL https://raw.githubusercontent.com/amirghm/hermes-agent-mobile/main/scripts/install-termux.sh)Requirements: An Android phone with Termux or an iPhone with iSH, and a model provider API key (the Android quick setup asks for an OpenRouter key and a Telegram bot token)
Note: On iOS the iSH version supports only CLI chat, memory, skills, file operations and web search.
FAQ
What is Hermes-Agent Mobile?
Hermes-Agent Mobile is an installer that puts Hermes Agent on an Android or iOS phone. It runs the agent locally in Termux or iSH and calls your model provider directly from the phone.
How do I install Hermes-Agent Mobile on Android?
Run the install-termux.sh script from the repository in Termux, using the bash and curl command shown in the README. It installs Debian, Firefox and Hermes, then asks how you want to configure them.
Does Hermes-Agent Mobile work on iPhone?
Partly. iSH supports CLI chat, memory, skills, file operations and web search, but the Telegram gateway, voice and cron jobs do not work because iSH lacks subprocess syscalls.
Similar deployment for Hermes Agent
All deploymentOne container running Hermes' gateway, dashboard and web UI with auto runtime detection
iranee Hermes Agent for fnOSNative fnOS NAS package that deploys Hermes Agent with a web control panel
Clawdi-AI ClawdiOpen-source agent hub: run managed Hermes or OpenClaw in the cloud, or connect agents on your own computer
zhangqi444 open-forgeSkill that lets your AI coding agent self-host 2,200+ open-source apps, from provisioning to TLS
WolframRavenwolf Hermes Agent Home Assistant Add-onHome Assistant add-on that runs Hermes Agent with a dashboard, web terminal and messaging gateway
42-evey Evey SetupShell installer for a Hermes Agent stack with LiteLLM, Ollama, Qdrant and 29 community plugins
Related guides: How to run Hermes Agent securely · How to install Hermes Agent · Connect Hermes agents on several machines with Hermes Desktop