Hermes Agent for Termux (proot-distro) for Hermes Agent

Installer scripts that run Hermes Agent on Android inside Termux using a proot-distro Debian or Ubuntu

What Hermes Agent for Termux (proot-distro) does

Two scripts, Hermes-debian.sh and Hermes-ubuntu.sh, detect whether proot-distro is already installed, configure the environment without data loss and install Hermes Agent. The README says installation takes about 15 to 20 minutes. Once installed, you start the agent with hermes, and the README points to hermes setup for provider keys, hermes model for switching models, hermes update and hermes doctor.

To let Hermes read or save files on the phone, run termux-setup-storage, after which shared storage is mapped under /data/data/com.termux/files/home/storage/. The README lists shell and file access, messaging through Telegram, Signal, WhatsApp, Discord and Slack, web browsing and arXiv search, and reusable skills with memory across sessions. It suggests adding a Kilo API key for free usage. A note at the top points to the official Termux guide in the Hermes Agent documentation.

Key features

Separate installers for proot-distro Debian and Ubuntu
Detects an existing proot-distro install and keeps data
Access to Android shared storage after termux-setup-storage
Messaging gateways for Telegram, Signal, WhatsApp, Discord and Slack
Standard Hermes commands: hermes setup, model, update and doctor

When to use it

Running Hermes Agent on an Android phone without a server
Letting Hermes read files from the phone's Downloads or DCIM folders
Trying Hermes with a free API provider on a spare device

Who it is for: Android users who want to run Hermes Agent locally in Termux.

How it fits with Hermes Agent

Built for Hermes Agent, installing it into a proot-distro guest on Android.

How to install Hermes Agent for Termux (proot-distro)

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

pkg update && pkg upgrade -y
curl -sL https://raw.githubusercontent.com/catamsp/hermes-proot-termux/refs/heads/main/Hermes-debian.sh | bash
curl -fsSL https://raw.githubusercontent.com/catamsp/hermes-proot-termux/refs/heads/main/Hermes-ubuntu.sh | bash

Requirements: Termux from F-Droid, Android 7.0 or higher and about 2 GB of free storage

Note: The README notes that Hermes Agent now has official Termux support, documented at hermes-agent.nousresearch.com/docs/getting-started/termux.

FAQ

What is Hermes Agent for Termux (proot-distro)?

It is a set of installer scripts that run Hermes Agent on Android inside Termux. The agent runs in a proot-distro Debian or Ubuntu environment.

How do I install Hermes Agent for Termux (proot-distro)?

Update Termux packages with pkg update && pkg upgrade -y, then run either the Debian or the Ubuntu installer with curl piped to bash. The README says it takes about 15 to 20 minutes.

What do I need to run Hermes Agent for Termux (proot-distro)?

You need the F-Droid version of Termux, Android 7.0 or higher and about 2 GB of free storage. The Google Play version of Termux is described as outdated.