sidebar_position: 3 title: “Android / Termux” description: “Run Hermes Agent directly on an Android phone with Termux”

使用 Termux 在 Android 上运行 Hermes

:::warning 二级平台 Termux（Android）属于二级平台。此处的安装脚本和文档仅以尽力维护的方式提供。对 main 分支的任何修改都可能随时导致这些软件包出现故障。: ::

通过 Termux，Hermes Agent 可直接在 Android 手机上运行。

它不仅能在手机上提供可用的本地 CLI，还支持目前已知可在 Android 上顺利安装的所有核心功能。

已测试的配置方案支持哪些功能？

经过测试的 Termux 安装包包含以下功能：

Hermes CLI
cron 任务支持
PTY/后台终端支持
Telegram 网关支持（手动触发/尽力保障后台运行）
MCP 支持
Honcho 内存管理支持
ACP 支持

具体对应关系如下：

python -m pip install -e '.[termux]' -c constraints-termux.txt

哪些功能尚未纳入测试范围？

目前仍有部分功能需要桌面/服务器端的依赖项，而这些依赖在 Android 平台上尚未发布，或尚未在手机上经过验证：

当前 Android 平台不支持 .[all] 选项
voice 额外功能被 faster-whisper -> ctranslate2 拦截，且 ctranslate2 未提供 Android 版预编译包
Termux 安装程序会跳过自动浏览器/Playwright 启动流程
Termux 内部不支持基于 Docker 的终端隔离功能
Android 系统仍可能暂停 Termux 的后台任务，因此网关数据的持久化属于尽力而为的机制，而非标准的管理服务体验

尽管如此，Hermes 依然可以作为一款专为手机设计的 CLI 智能体正常运行——只是其推荐的移动端安装方案在功能范围上刻意比桌面/服务器端版本更为精简。

方案一：单行安装程序

Hermes 现已提供兼容 Termux 的安装程序路径：

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

在 Termux 环境中，安装程序会自动执行以下操作：

使用 pkg 命令来安装系统软件包；
通过 python -m venv 创建虚拟环境；
首先尝试使用内容更全面的 .[termux-all] 扩展包，若失败则回退到内容较少的 .[termux] 扩展包（最后再进行基础安装）——curl 安装工具会自动遵循这一顺序；
将 hermes 命令链接到 $PREFIX/bin 目录中，从而确保其始终位于 Termux 的路径搜索范围内；
跳过尚未经过测试的浏览器及 WhatsApp 启动程序。

如果您需要具体的命令或想要调试安装失败的问题，可参考下方的手动安装方式。

方案 2：手动安装（完全明确指定步骤）

1. 更新 Termux 并安装系统软件包

pkg update
pkg install -y git python clang rust make pkg-config libffi openssl nodejs ripgrep ffmpeg

为何选择这些软件包？

python — 提供运行时环境及虚拟环境支持；
git — 用于克隆或更新代码仓库；
clang、rust、make、pkg-config、libffi、openssl — 用于在 Android 环境下构建部分 Python 依赖项；
nodejs — 作为可选的 Node 运行时环境，用于测试核心功能之外的实验场景；
ripgrep — 实现快速文件搜索功能；
ffmpeg — 用于媒体文件处理及文本转语音操作。

2. 克隆 Hermes

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

3. 创建虚拟环境

python -m venv venv
source venv/bin/activate
export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
python -m pip install --upgrade pip setuptools wheel

对于基于 Rust 和 maturin 开发的包（如 jiter），ANDROID_API_LEVEL 是一个非常重要的参数。

4. 安装已测试过的 Termux 包络文件

python -m pip install -e '.[termux]' -c constraints-termux.txt

如果您只需最基础的核心智能体，采用这种方式也同样可行：

python -m pip install -e '.' -c constraints-termux.txt

5. 将 `hermes` 添加到 Termux 的 PATH 环境变量中

ln -sf "$PWD/venv/bin/hermes" "$PREFIX/bin/hermes"

在 Termux 中，`$

hermes version
hermes doctor

7. 启动 Hermes Agent

hermes

故障排除

安装 `.[all]` 时出现“未找到解决方案”错误

请改用经过测试的 Termux 包：

python -m pip install -e '.[termux]' -c constraints-termux.txt

目前造成问题的组件是 voice 插件：

voice 会调用 faster-whisper；
faster-whisper 又依赖于 ctranslate2；
而 ctranslate2 并不提供适用于 Android 的预编译包。

在 Android 设备上使用 `uv pip install` 会失败

请改用 Termux 环境下的 stdlib venv 配合 pip 命令来安装：

python -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

`jiter` / `maturin` 会针对 `ANDROID_API_LEVEL` 发出警告

请在安装之前明确指定 API 级别：

export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
python -m pip install -e '.[termux]' -c constraints-termux.txt

`hermes doctor`提示缺少ripgrep或Node工具

可通过Termux包进行安装：

pkg install ripgrep nodejs

安装 Python 包时出现构建失败

请确保已安装构建工具链：

pkg install clang rust make pkg-config libffi openssl

然后重新尝试：

python -m pip install -e '.[termux]' -c constraints-termux.txt

手机端已知的限制

不支持 Docker 后端
在测试环境中无法通过 faster-whisper 进行本地语音转录
安装程序会刻意跳过浏览器自动化相关的配置步骤
虽然部分附加组件可能仍可使用，但目前仅有 .[termux] 和 .[termux-all] 被列为经过测试的 Android 版本包

如果您遇到新的与 Android 环境相关的问题，请在 GitHub 上创建一个问题报告，并附上以下信息：

您的 Android 系统版本
termux-info 的输出结果
python --version 的输出结果
hermes doctor 的检测结果
完整的安装命令及错误日志

Hermes Agent Docs i18n