Android / Termux
Hermes on Android with Termux This is the tested path for running Hermes Agent directly on an Android phone through Termux. It gives you a working local CLI on
This is the tested path for running Hermes Agent directly on an Android phone through Termux. It gives you a working local CLI on the phone, plus the core extras that are currently known to install cleanly on Android. …
What this page covers
- What is supported in the tested path?
- What is not part of the tested path yet?
- Option 1: One-line installer
- Option 2: Manual install (fully explicit)
- 1. Update Termux and install system packages
- 2. Clone Hermes
- 3. Create a virtual environment
- 4. Install the tested Termux bundle
- 5. Put hermes on your Termux PATH
- 6. Verify the install
- 7. Start Hermes
- Recommended follow-up setup
- Configure a model
- Re-run the full interactive setup wizard later
- Install optional Node dependencies manually
- Troubleshooting
- No solution found when installing .[all]
- uv pip install fails on Android
- jiter / maturin complains about ANDROIDAPILEVEL
- hermes doctor says ripgrep or Node is missing
- Build failures while installing Python packages
- Known limitations on phones
Section outline mirrored from the official Hermes Agent documentation. Follow any heading to read the complete text on the source site.
More in Getting Started
Installation
Get Hermes Agent up and running in under two minutes! Quick Install With the Hermes Desktop installer on macOS or Windows (recommended) To easily install the co
Quickstart
This guide gets you from zero to a working Hermes setup that survives real use. Install, choose a provider, verify a working chat, and know exactly what to do w
Learning Path
Hermes Agent can do a lot — CLI assistant, Telegram/Discord bot, task automation, RL training, and more. This page helps you figure out where to start and what
Updating & Uninstalling
Updating Git installs Update to the latest version with a single command: This pulls the latest code from , updates dependencies, and prompts you to configure a
Nix & NixOS Setup
Hermes Agent ships a Nix flake with three levels of integration: Level Who it's for What you get / Any Nix user (macOS, Linux) Pre built binary with all deps —