Files

ethernet 1ce0998ac9 refactor(termux): reuse package requirements and harden launchers

Use one requirements writer for the wheelhouse and installed venv. Do not retry failed hashes or paused downloads. Skip pure-wheel decompression, preserve runtime library notices, and keep the current working directory off the launcher import path. Document the prerelease canary package without migration or downgrade guidance.

2026-09-06 14:34:52 -04:00

4.0 KiB

Raw Blame History

sidebar_position, title, description

sidebar_position	title	description
3	Android / Termux	Install Hermes Agent on Android with the signed Termux package

Hermes on Android with Termux

The Termux package runs Hermes on aarch64 (arm64-v8a) Android devices. This package is in prerelease testing.

The package includes Python, Node.js, npm, uv, ripgrep, ffmpeg, and their runtime libraries. CI builds the native Python wheels and the TUI before it creates the package. The device does not compile dependencies or assemble a Python environment during installation.

Install

Use the standard Termux application. The package requires its standard prefix, /data/data/com.termux/files/usr. Other architectures and renamed Termux application packages are not supported.

Install the tools for repository setup:
```
pkg install curl gnupg
```

Download the public key:

mkdir -p "$PREFIX/etc/apt/keyrings"
curl -fsSL \
  https://hermes-assets.nousresearch.com/releases/termux/canary/key.asc \
  -o "$PREFIX/etc/apt/keyrings/hermes-agent.asc"

Verify its primary fingerprint:
```
gpg --show-keys --with-fingerprint "$PREFIX/etc/apt/keyrings/hermes-agent.asc"
```
The repository key fingerprint is:
```
C572 B5FD D1A2 9CCF A9A9 12B6 840B 0848 E139 156D
```
If the fingerprint differs, stop. Do not disable signature verification.

Add the canary repository:

printf '%s\n' \
  "deb [signed-by=$PREFIX/etc/apt/keyrings/hermes-agent.asc] https://hermes-assets.nousresearch.com/releases/termux/canary hermes-canary main" \
  > "$PREFIX/etc/apt/sources.list.d/hermes-agent.list"

Install Hermes:
```
pkg update
pkg install hermes-agent
```
Configure a provider, then start the TUI:
```
hermes setup
hermes --tui
```

The hermes, hermes-agent, and hermes-acp commands use the packaged runtimes. They do not require Termux's python or nodejs packages.

Files and updates

Contents	Location
Package files	`$PREFIX/lib/hermes-agent/`
Command symlinks	`$PREFIX/bin/hermes`, `$PREFIX/bin/hermes-agent`, `$PREFIX/bin/hermes-acp`
Configuration and user data	`~/.hermes/`, or the selected `HERMES_HOME`

Update through APT:

pkg upgrade hermes-agent

hermes update refuses to modify an APT-owned installation. It prints the package-manager command instead. Canary versions contain ~canary.<timestamp> and sort before the corresponding stable version.

Gateway

Termux has no system service manager. Run the gateway in a Termux session:

hermes gateway run

For a background process:

mkdir -p "${HERMES_HOME:-$HOME/.hermes}/logs"
nohup hermes gateway run >> "${HERMES_HOME:-$HOME/.hermes}/logs/gateway.log" 2>&1 &

:::warning Android process limits Android can suspend or terminate background Termux processes. Battery optimization exemptions and termux-wake-lock can help, but do not guarantee persistent operation. :::

Limits

The package does not include the nemo-relay exporter because its build does not support this target. Optional integrations can require additional dependencies or services. A prebuilt core runtime does not guarantee that every third-party plugin supports Android.

Uninstall

pkg uninstall hermes-agent

APT removes the package and its command symlinks. It preserves your configuration, sessions, skills, and memories.

Troubleshooting

Package not found: verify the repository entry, then run pkg update.
Signature error: verify the public key fingerprint. Do not use an unsigned repository or bypass the error.
Missing command: verify that $PREFIX/bin is on PATH, or reinstall the package.
Missing library or TUI bundle: report hermes --version and the complete error. The core package must not require a local rebuild.
Gateway stops with the screen off: review Android's battery and background-process limits.

For general diagnostics, run hermes doctor.

4.0 KiB Raw Blame History