Android 和 Termux (Android / Termux)

> 📖 本文档翻译自 Hermes Agent 官方文档 > 最后更新：2026-04-16

这是通过 Termux 在 Android 手机上直接运行 Hermes Agent 的经过测试的路径。

它为你提供手机上可用的本地 CLI，以及目前已知能在 Android 上顺利安装的核心扩展组件。

经过测试的路径支持哪些功能？

经过测试的 Termux 打包安装以下内容：

• Hermes CLI
• Cron（定时任务）支持
• PTY / 后台终端支持
• Telegram Gateway 支持（手动 / 尽力而为的后台运行）
• MCP 支持
• Honcho 记忆支持
• ACP 支持

具体来说，它映射到：

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

尚未纳入测试路径的功能

一些功能仍然需要桌面/服务器端的依赖，而这些依赖尚未为 Android 发布，或者在手机上尚未经过验证：

• .[all] 目前在 Android 上不受支持
• voice 扩展被 faster-whisper -> ctranslate2 阻挡，ctranslate2 没有发布 Android Wheel
• 自动浏览器 / Playwright 引导在 Termux 安装程序中被跳过
• 基于 Docker 的终端隔离在 Termux 中不可用
• Android 可能仍会暂停 Termux 的后台任务，因此 Gateway 持久性是尽力而为的，而非标准的托管服务

这并不妨碍 Hermes 作为手机原生 CLI Agent 正常工作——只是推荐的移动端安装范围比桌面/服务器端有意收窄。

方式 1：一行安装

Hermes 现在提供了 Termux 感知的安装路径：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

在 Termux 上，安装程序会自动：

• 使用 pkg 安装系统包
• 使用 python -m venv 创建虚拟环境
• 使用 pip 安装 .[termux]
• 将 hermes 链接到 $PREFIX/bin，使其保持在你的 Termux PATH 上
• 跳过未经测试的浏览器 / WhatsApp 引导

如果你想要完整的显式命令或需要调试安装失败，请使用下面的手动路径。

方式 2：手动安装（完整步骤）

1. 更新 Termux 并安装系统包

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

为什么需要这些包？

• python — 运行时 + venv 支持
• git — 克隆/更新仓库
• clang、rust、make、pkg-config、libffi、openssl — 在 Android 上构建某些 Python 依赖所需
• nodejs — 可选的 Node 运行时，用于测试核心路径之外的实验性功能
• ripgrep — 快速文件搜索
• ffmpeg — 媒体 / TTS 转换

2. 克隆 Hermes

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

如果你已经克隆但没有子模块：

git submodule update --init --recursive

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

ANDROID_API_LEVEL 对于 Rust / maturin 构建的包（如 jiter）非常重要。

4. 安装经过测试的 Termux 打包

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

如果你只想要最小核心 Agent，这也可以：

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

5. 将 hermes 放到你的 Termux PATH 上

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

$PREFIX/bin 已经在 Termux 的 PATH 中，所以这让 hermes 命令在新 Shell 中持久可用，无需每次重新激活虚拟环境。

6. 验证安装

hermes version
hermes doctor

7. 启动 Hermes

hermes

推荐的后续设置

配置模型

hermes model

或者直接在 ~/.hermes/.env 中设置 Key。

之后重新运行完整的交互式设置向导

hermes setup

手动安装可选的 Node 依赖

经过测试的 Termux 路径有意跳过了 Node/浏览器引导。如果你想稍后实验浏览器工具：

pkg install nodejs-lts
npm install

浏览器工具会自动将 Termux 目录（/data/data/com.termux/files/usr/bin）包含在其 PATH 搜索中，因此 agent-browser 和 npx 可以被发现，无需额外的 PATH 配置。

在另有文档说明之前，请将 Android 上的浏览器 / WhatsApp 工具视为实验性功能。

故障排除

安装 .[all] 时出现 No solution found

请改用经过测试的 Termux 打包：

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

目前的阻碍是 voice 扩展：

• voice 拉取 faster-whisper
• faster-whisper 依赖 ctranslate2
• ctranslate2 没有发布 Android Wheel

uv pip install 在 Android 上失败

请使用标准库 venv + pip 的 Termux 路径：

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 Level：

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] 被记录为经过测试的 Android 打包

如果你遇到新的 Android 特定问题，请提交 GitHub Issue 并附上：

• 你的 Android 版本
• termux-info 输出
• python --version 输出
• hermes doctor 输出
• 确切的安装命令和完整的错误输出