Hermes Agent 安卓 Termux 运行指南：官方安装面、依赖约束与定位

官方一键脚本本身就支持 Termux

README 的 Quick Install 一节把 Termux 与 Linux、macOS、WSL2 并列，共用同一条安装命令：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

在 Termux 里，安装脚本会自动改用 pkg 装系统包、用 python -m venv 建虚拟环境，并把 hermes 链接到 $PREFIX/bin，浏览器和 WhatsApp 这类没测过的组件会直接跳过。要注意的是，官方现在把 Termux 列为二档平台（Tier 2）：脚本和文档按尽力维护的标准更新，主分支的改动随时可能让它暂时装不上。所以手机上能装、也有官方指南（getting-started/termux），但别把它当成和桌面系统一样稳的安装面。

一键脚本失败时：按官方手动路径装

完整的 .[all] 依赖组会带进与 Android 不兼容的语音依赖，所以 Termux 装的是裁剪过的 .[termux] 依赖组，官方仓库用 constraints-termux.txt 把一批包锁在 Termux 可用的版本区间内。还有一个新坑：Hermes 要求 Python 3.11 到 3.13，而 Termux 当前默认的 python 已经是 3.14，超出范围，需要先从 TUR 仓库装 3.13：

pkg update
pkg install -y git python clang rust make pkg-config libffi openssl nodejs ripgrep ffmpeg
pkg install tur-repo
pkg install python3.13

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
python3.13 -m venv venv
source venv/bin/activate
export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
python -m pip install --upgrade pip setuptools wheel
python -m pip install -e '.[termux]' -c constraints-termux.txt
ln -sf "$PWD/venv/bin/hermes" "$PREFIX/bin/hermes"

ANDROID_API_LEVEL 是给 jiter 这类用 Rust 编译的依赖用的，漏了容易编译失败。遇到依赖编译失败，先对照官方 Termux 指南确认步骤，不要自己把约束文件里的版本往上抬——那些区间就是为了避开 Android 上装不动的版本才存在的。

手机上的 Gateway 只有前台一条路

Android 没有 systemd，hermes gateway install 的系统服务模式用不上。官方对 Termux 的推荐就是前台运行：

hermes gateway run

代价是 Termux 会话必须保持存活。Android 的后台杀进程策略比桌面系统激进得多，锁屏一段时间后进程可能被回收；把 Termux 加进电池优化白名单能缓解，但改变不了手机不适合当长期值守服务器这个事实。

手机的合理定位：第二入口，不是主机

更稳的组合是双层结构：Hermes 装在 VPS 或常开的电脑上长期值守，手机通过 Telegram 这类已接入的消息平台随时指挥它；Termux 本机安装则承担两件事——离线试验 CLI，以及在外面临时排查（hermes status 和 hermes logs 都能直接跑）。这样既有移动入口，又不依赖手机进程存活。

装完先跑这三条验收

hermes --version
hermes doctor
hermes -z "用一句话确认你能正常回复"

版本号正常返回、依赖检查通过、单次问答能出结果，再考虑配 gateway 或定时任务。三条里任何一条卡住，先解决它再往下走，顺序不要颠倒。

还没有真实场景？可以先领取 Free Starter 模板包，从低风险只读任务开始试跑。