第十一篇:手机也能跑 Hermes——安卓 Termux 安装指南
Hermes Agent 官方教程第十一篇:在安卓手机上用 Termux 安装运行 Hermes,随时随地指挥 AI。
第十一篇:手机也能跑 Hermes——安卓 Termux 安装指南
嘿,朋友们!之前咱们聊了在电脑上装 Hermes,今天来点更硬核的——在安卓手机上跑 Hermes!没错,你的手机不只是刷视频、聊微信的工具,它还能成为你的 AI 助手终端。而且官方安装脚本已经正式支持 Termux 了,一条命令搞定,比你想的简单得多。
:::warning Tier 2 平台
Termux(安卓)属于 Tier 2 平台。安装脚本和文档只是尽力维护,main 分支的提交随时可能弄坏这些包。
:::
先装 Termux,再跑一条命令
Termux 是安卓上的终端模拟器,相当于给手机装了个迷你 Linux 环境。去 F-Droid 或 GitHub 下载安装 Termux(别用 Play 商店的旧版本),打开后先更新一下包:
pkg update && pkg upgrade
然后装上 Git(这是唯一必须的依赖):
pkg install git
接下来就是见证奇迹的时刻——运行官方一键安装脚本:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
等等,有朋友要问了:curl 哪来的? 别急,Termux 里默认没有 curl,先装一下:
pkg install curl xz-utils
装完 curl 和 xz-utils 后再跑上面那条安装命令,脚本会自动帮你搞定剩下的一切:Python、Node.js、ripgrep、ffmpeg……全自动安装,你只需要泡杯咖啡等着。
在 Termux 上,安装器会自动:用 pkg 装系统包;用 python -m venv 创建虚拟环境;先尝试更全的 .[termux-all] extra,失败再退回较小的 .[termux] extra(再不行就装基础版);把 hermes 链接到 $PREFIX/bin,让它留在你的 Termux PATH 里;跳过未测试的浏览器 / WhatsApp 引导。
:::warning 支持的 Python 版本范围
Hermes 要求 Python >=3.11,<3.14。当前 Termux 自带的是 python 3.14.x,超出了这个范围——安装器会检测到这一点,并自动去 Termux User Repository (TUR) 找一个受支持的解释器。如果想手动安装,自己装一个:
pkg install tur-repo
pkg install python3.13
然后在下面的命令里用 python3.13 代替 python(例如 python3.13 -m venv venv)。
:::
装完怎么用?
安装完成后,刷新一下 shell 环境:
source ~/.bashrc
然后直接输入 hermes 就能开始聊天了!是不是很丝滑?
几个常用配置命令
装好之后,你随时可以用这些命令调整设置:
hermes model—— 切换 LLM 提供商和模型hermes tools—— 配置启用的工具hermes gateway setup—— 设置消息平台接入hermes config set—— 修改单个配置项hermes setup—— 或者直接跑完整配置向导
小贴士:如果你不想一个个配置 API key,试试这个:
hermes setup --portal
一条命令完成登录、设置 Nous 为提供商、开启 Tool Gateway(网页搜索、图片生成、TTS 等工具全包),省心到飞起。
文件都装在哪了?
普通用户安装的话,代码在 ~/.hermes/hermes-agent/,hermes 命令软链接到 ~/.local/bin/hermes,数据目录在 ~/.hermes/。想卸载?直接删掉这几个目录就行,干净利落。
社区维护的原生 pkg 安装方式
:::caution 贡献者运营的发行版
这个 APT 仓库由 @adybag14-cyber 社区维护,不是 NousResearch 官方发行版。NousResearch 不构建、不签名、不托管、也不审计这些包。启用该仓库意味着你要信任这个由贡献者运营的仓库及其签名密钥。Termux 本身仍是 Tier 2 / 尽力维护的平台。
:::
如果你更想用原生包管理器安装,而不是在手机上编译 Python/Rust 依赖,可以用这个社区维护的 APT 仓库。仓库引导脚本和打包源码发布在 adybag14-cyber/termux-python,Hermes 包的构建在 adybag14-cyber/termux-hermes。
安装仓库密钥/源和 Hermes:
curl -fsSL https://raw.githubusercontent.com/adybag14-cyber/termux-python/main/scripts/setup_apt_repo.sh | bash
pkg install hermes-agent
社区发行版目前记录的仓库签名密钥指纹是:
EAD24A2124EFA7393A78B7B14699F966313F7A6B
通过 APT 安装的 Hermes 会被标记为安装方式 apt。因此 Hermes 不会对包管理的文件运行 Git 自更新器;请改用包管理器:
pkg update
pkg upgrade hermes-agent
这个选项的打包/仓库/签名问题请报告给上面的社区打包仓库。Hermes 运行时 bug 仍然可以在这里报告,但请记住安卓/Termux 支持是尽力而为的。
手机性能够吗?
说实话,跑是能跑,但手机毕竟不是电脑。日常聊天、写代码、查资料完全没问题,但如果跑特别重的任务,手机会发热——记得给手机散散热,别边充边跑哈。
手机上已知的限制
- 不支持
.[all],目前安卓上只测试了.[termux]和.[termux-all]这两个 bundle voiceextra 被faster-whisper -> ctranslate2卡住,ctranslate2没有发布安卓 wheel,所以本地语音转写用不了- 安装器会故意跳过浏览器 / Playwright 引导,安卓上的浏览器 / WhatsApp 工具请当作实验性功能
- Termux 里没有基于 Docker 的终端隔离
- 安卓可能仍会挂起 Termux 的后台任务,所以 gateway 的持久化只是尽力而为,不是正常的托管服务
小结
在手机上装 Hermes 就三步:装 Termux → 装 curl 和 git → 跑官方脚本。剩下的交给安装器自动处理。以后出门在外,掏出手机就能跟你的 AI 助手聊天,是不是很酷?
下期咱们聊聊怎么把 Hermes 从一台机器迁移到另一台,或者试试多机同步?评论区告诉我你想看啥!
📖 官方文档
本文根据 Hermes Agent 官方文档编写,原文见:官方文档 › getting-started/termux