🤖HermesBlog
Hermes 官方教程 · 第11篇2026/8/9· Easy Understand Hermes Agent

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

Hermes Agent 官方教程第十一篇:在安卓手机上用 Termux 安装运行 Hermes,随时随地指挥 AI。

手机也能跑 Hermes:Termux 安装

第十一篇:手机也能跑 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
  • voice extra 被 faster-whisper -> ctranslate2 卡住,ctranslate2 没有发布安卓 wheel,所以本地语音转写用不了
  • 安装器会故意跳过浏览器 / Playwright 引导,安卓上的浏览器 / WhatsApp 工具请当作实验性功能
  • Termux 里没有基于 Docker 的终端隔离
  • 安卓可能仍会挂起 Termux 的后台任务,所以 gateway 的持久化只是尽力而为,不是正常的托管服务

小结

在手机上装 Hermes 就三步:装 Termux → 装 curl 和 git → 跑官方脚本。剩下的交给安装器自动处理。以后出门在外,掏出手机就能跟你的 AI 助手聊天,是不是很酷?

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

📖 官方文档

本文根据 Hermes Agent 官方文档编写,原文见:官方文档 › getting-started/termux