Hermes 官方教程！在安卓手机上安装 Hermes Agent

## 前提条件，手机上已经安装 Termux ，另外第三方的 ZeroTermux 使用体验也挺好

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

## 1. 更新 Termux 并安装系统包

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

## 2. 克隆 Hermes

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

## 如果担心从 github 拉取代码时漏了子模块，可以运行如下命令

git submodule update --init --recursive


## 3. 创建虚拟环境

python -m venv venv
source 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 激活虚拟环境） 。

## 验证安装

hermes version
hermes doctor

##  启动 Hermes

hermes

## 配置模型
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 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
 

## 故障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