Hermes Atlas
Deployment & hosting

Hermes-Agent Mobile

amirghm/hermes-agent-mobile

Installer that runs Hermes Agent on a phone: Android through Termux, iOS through iSH with limits

In short

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 deployment

Related guides: How to run Hermes Agent securely · How to install Hermes Agent · Connect Hermes agents on several machines with Hermes Desktop