Hermes Agent for Termux (Android)

Install Hermes Agent on Termux without compiling. Prebuilt, checksum-verified Python wheels for aarch64 Android, built in CI, so your phone never runs a compiler.

curl -fsSL https://raw.githubusercontent.com/bd-loser/hermes-bionic/main/install.sh | bash

Optional, in the same run: --with-camoufox installs the Bionic-native anti-fingerprint Firefox engine (camoufox command).

Updating: upstream blocks hermes update on Termux source checkouts — just rerun the command above; it resolves the newest release (with a matching Python-3.14 bundle), rebuilds the venv, and re-links hermes. Takes a few minutes and never compiles anything.

Optional camoufox (anti-fingerprint Firefox engine, camoufox command):

curl -fsSL https://raw.githubusercontent.com/bd-loser/hermes-bionic/main/install.sh | bash -s -- --with-camoufox

Why this exists

Upstream Hermes depends on native packages (cryptography, pydantic-core, Pillow, and more). On a phone each one compiles from source, which is slow and often fails. This project compiles them once in CI and installs them offline.

Features

• One-command install on Termux, Python 3.14, aarch64
• Verified installs: SHA-256 checked, and a mismatch stops the install
• No on-device compiler needed
• DuckDuckGo web search that works on Termux (ddgs, no API key)
• Browser automation with a native Android agent-browser and Termux Chromium

Documentation

Guide	What it covers
Install	Requirements, install, upgrade, uninstall
DuckDuckGo search	Search on Termux and its DNS trade-off
Browser automation	Chromium and agent-browser on Android
Troubleshooting	Common errors and fixes
Architecture	How the build and installer work
Releasing	Maintainer release process

Status

• Stable release: v0.22.0 (Hermes 0.22.0, Python 3.14, aarch64)
• Verified on one Termux phone: install, Hermes startup, DuckDuckGo search, and browser basics.
• Not yet verified: other Android devices and Android versions.

Related

• Hermes Agent: upstream project
• opencode-bionic: same approach for OpenCode
• camoufox-bionic: Bionic-native Camoufox (anti-fingerprint Firefox) for Termux — built natively, no glibc/proot; powers Hermes' Camofox provider

Contributing and issues

Report problems at issues, with your hermes --version, Android version, and the full error output.

License

This repository does not yet include a license file. Hermes Agent itself is licensed by its upstream project.