第十一篇：手机也能跑 Hermes——安卓 Termux 安装指南

嘿，朋友们！今天来点更硬核的——在安卓手机上跑 Hermes！现在官方已经提供签名的 APT 包，pkg install hermes-agent 就能装好，不用在手机上编译 Python 依赖，比你想的简单得多。

:::danger Termux 包目前暂时不可用官方 Termux 包现在跑不起来，修复正在进行中，很快就会发布。在修好之前，下面的步骤可能失败，或者装上了一个跑不起来的包。装之前建议先去官方文档再确认一眼。 :::

:::warning Tier 2 平台 Termux（安卓）属于 Tier 2 平台。发布有可能把它弄坏，而且修复不保证及时。安卓 / Termux 只在 aarch64 上受支持。 :::

官方 APT 包：两个通道

这个包只跑在 aarch64（arm64-v8a） 的安卓设备上。APT 仓库发布在 https://hermes-assets.nousresearch.com/releases/termux/<channel>，有两个通道：

通道	APT suite	内容
`stable`	`hermes-stable`	通过稳定发布门禁的 `vMAJOR.MINOR.PATCH` 正式版本
`canary`	`hermes-canary`	canary 标签的预发布构建，版本号带 `~canary.<timestamp>`

下面的步骤用的是 stable。想跟预发布版，把第 2 步和第 4 步里的 stable 换成 canary、hermes-stable 换成 hermes-canary 就行——两个通道用同一把密钥签名。

包里已经包含 Python、Node.js、npm、uv、ripgrep、ffmpeg 以及它们的运行库。CI 在打包前就把原生 Python wheel 和 TUI 都编译好了，设备上不编译核心依赖，也不组装基础 Python 环境。包用的是带 bionic interpreter pin 的 Python 3.14，不要求和桌面版 CPython 补丁号一致；wheel 闭包是 core 加 acp，不是桌面全套 extras。

安装步骤

请使用标准的 Termux 应用。这个包要求标准的 prefix /data/data/com.termux/files/usr，其他架构和被改名的 Termux 应用包都不支持；wheel 目标平台是 Android API 24（android_24_arm64_v8a）。别在安卓上用桌面/服务器的 install.sh，也别用 glibc 版 Linux 归档。

先装仓库配置工具：
```
pkg install curl gnupg
```

下载公钥：

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

核对主指纹：

gpg --show-keys --with-fingerprint "$PREFIX/etc/apt/keyrings/hermes-agent.asc"

仓库密钥指纹是：

C572 B5FD D1A2 9CCF A9A9 12B6 840B 0848 E139 156D

指纹对不上就停下来，不要关掉签名校验。

添加仓库：

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

安装 Hermes：
```
pkg update
pkg install hermes-agent
```
配置提供商，然后启动 TUI：
```
hermes setup
hermes --tui
```

hermes、hermes-agent、hermes-acp 这三个命令用的都是包里自带的运行时，不需要 Termux 再装 python 或 nodejs。

文件位置与更新

内容	位置
包文件	`$PREFIX/lib/hermes-agent/`
命令软链接	`$PREFIX/bin/hermes`、`$PREFIX/bin/hermes-agent`、`$PREFIX/bin/hermes-acp`
配置和用户数据	`~/.hermes/`，或你选定的 `HERMES_HOME`

更新走 APT：

pkg update
pkg upgrade hermes-agent

hermes update 拒绝修改 APT 管理的安装，它只会打印出该用的包管理器命令。另外注意：canary 版本号里的 ~canary.<timestamp> 在排序上位于对应的 stable 版本之前；每个 suite 只列出自己通道的包，所以想换通道，得改 hermes-agent.list 里的通道路径和 suite，然后 pkg update && pkg upgrade hermes-agent。

跑网关

这个 APT 安装不用 systemd、launchd 或 Windows 计划任务，直接在 Termux 会话里跑：

hermes gateway run

需要后台跑的话：

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

:::warning 安卓的进程限制安卓可能挂起或直接杀掉 Termux 的后台进程。关掉电池优化、配合 termux-wake-lock 会有帮助，但都不保证能一直活着。 :::

手机上已知的限制

包里不包含 nemo-relay 导出器——它内置的构建工具链不支持这个目标平台
不包含 Electron、内置 Chromium 和桌面版 computer-use 工具；浏览器工具会在 PATH 里找到系统 chromium 时启动它（pkg install chromium，前提是你的仓库提供），找不到时浏览功能不可用，浏览器工具会明确提示
Termux 环境里没有本地 Docker daemon；远程服务也有它们自己的要求和网络限制
不提供 Termux:API 的手机原生麦克风、剪贴板适配器。装好了 CLI/TUI 并不等于本地语音或唤醒词可用
可选集成和第三方插件可能需要安卓上不存在的依赖
这个目标平台上 Python 3.14 报告 sys.platform == "android"，所以只对 linux 放行的依赖或技能，在安卓上不会自动可用

卸载

pkg uninstall hermes-agent

APT 会删掉包和命令软链接，但会保留你的配置、会话、技能和记忆。

排错

找不到包：检查仓库条目是否正确，然后重新 pkg update
签名报错：核对公钥指纹。不要用未签名的仓库，也不要绕过报错
命令缺失：确认 $PREFIX/bin 在 PATH 里，或者重装这个包
缺库或 TUI bundle：把 hermes --version 和完整报错一起报上来。核心包不需要本地重新编译
息屏后网关就停：去看安卓的电池和后台进程限制
通用诊断还是那句：hermes doctor

小结

在手机上跑 Hermes 现在是三步：加官方签名源 → pkg install hermes-agent → hermes setup。但别忘了开头那句提醒——这个包目前暂时是坏的，修复版很快会来，动手前先瞄一眼官方文档的最新状态。

下期咱们聊聊怎么把 Hermes 从一台机器迁移到另一台，或者试试多机同步？评论区告诉我你想看啥！