夜雨聆风如下步骤是通过 Termux 在 Android 手机上直接运行 Hermes Agent 的经过测试可行的方法。
Termux 为你提供了一个可在手机上运行的本地 CLI（命令行界面），以及当前已知能在 Android 上干净安装的核心功能及部分可选功能。
经过测试验证的安装方法主要可使用如下功能：
经过测试的 Termux 组件包会安装：
* Hermes CLI
* cron 定时任务支持
* PTY/后台终端支持
* MCP 支持
* Honcho 记忆支持
* ACP 支持
具体来说，它对应于以下安装命令：
python -m pip install -e '.[termux]' -c constraints-termux.txt
如下功能没有经过测试（可能安装失败）：
主要是因为部分功能仍然需要 桌面/服务器 环境的依赖项，而这些依赖项尚未发布适用于 Android 的版本，或者尚未在手机上经过验证：
* .[all] 安装方式目前在 Android 上不受支持
* voice 可选功能被 faster-whisper → ctranslate2 这条依赖链所阻碍而不能使用，因为 ctranslate2 没有发布适用于 Android 的预编译包
* automatic browser / Playwright bootstrap 在 Termux 安装程序中会被跳过
* 基于 Docker 的终端隔离在 Termux 环境中不可用
但是上述这些问题并不妨碍 Hermes 作为一个手机原生的 CLI Agent 进行正常使用，只是意味着移动端安装范围有意比桌面/服务器端安装更加精简。
Hermes Agent 安装教程：
方法1：一键自动安装
## 前提条件，手机上已经安装 Termux ，另外第三方的 ZeroTermux 使用体验也挺好curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
方法2：手动安装（每一步都完全透明）
## 1. 更新 Termux 并安装系统包pkg updatepkg 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` — 用于媒体处理/文本转语音转换
## 2. 克隆 Hermesgit clone --recurse-submodules https://github.com/NousResearch/hermes-agent.gitcd hermes-agent## 如果担心从 github 拉取代码时漏了子模块，可以运行如下命令git submodule update --init --recursive## 3. 创建虚拟环境python -m venv venvsource venv/bin/activate## 因 ANDROID_API_LEVEL 对于基于 Rust / maturin 的包（如 jiter）非常重要，所以要设置到环境变量中export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"python -m pip install --upgrade pip setuptools wheel## 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 环境变量里，因此这个操作可以让你在新的 shell 中直接使用 `hermes` 命令，## 而无需每次都重新激活虚拟环境（不需要使用 source venv/bin/activate 激活虚拟环境） 。
PS：上面的安装步骤，如果都顺利完成（可能大多数人的上网环境都不能一次性成功！办法是使用一些特殊上网技能 ！），后面的步骤就是与 hermes 进行初步交互了 ！
## 验证安装hermes versionhermes doctor## 启动 Hermeshermes
推荐的后续设置，主要包括大模型提供商（必须）、Node（非必须） 安装等
## 配置模型hermes model### 或者直接将密钥设置在 ~/.hermes/.env 文件中。## 也可以稍后重新运行完整的交互式设置向导进行大模型提供商等的相关配置hermes setup## 手动安装可选的 Node 依赖## 默认经过测试的 Termux 安装步骤会有意跳过了 Node/browser bootstrap 环境的安装。手动安装方式如下 ：npm install
## 故障1：使用“ .[all] ”方式安装时，提示“No solution found”##解决办法：请使用经过测试的 Termux 组件包：python -m pip install -e '.[termux]' -c constraints-termux.txt## 主要是因为 voice 这个可选功能导致的失败：* voice` 会拉取 faster-whisper* faster-whisper 依赖于 ctranslate2* ctranslate2 没有发布适用于 Android 的预编译包
## 故障2：提示 uv pip install 安装失败## 解决办法：请使用 Termux 路径，配合标准库的 venv 和 pip 代替：python -m venv venvsource venv/bin/activateexport ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"python -m pip install --upgrade pip setuptools wheelpython -m pip install -e '.[termux]' -c constraints-termux.txt
## 故障3： 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
## 故障4：hermes doctor 提示 ripgrep 或 Node 缺失## 解决办法：使用 Termux 自带包管理器 pkg 重新安装它们：pkg install ripgrep nodejs
## 故障5：安装 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 命令的输出
* 确切的安装命令和完整的错误输出。
我自己手机使用的 ZeroTermux 一键安装的 Hermes ，需要特殊上网技能，约需要1小时，占用了大约 3G 左右的存储空间，安装完成后，所有配置为空，安装后效果如下图所示：
Hermes 安装完成，慢慢探索吧！
