若Termux安装Hermes Agent失败，应先换国内镜像源（如清华TUNA），再运行官方install.sh脚本；失败时可手动安装Python依赖并创建软链接；ARM设备需为jiter创建Python桩文件修复Rust兼容性问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在安卓手机上运行 Hermes Agent 这一本地 AI 智能体，但 Termux 环境安装失败或无法启动，则可能是由于软件源不可达、依赖缺失或架构兼容性问题。以下是解决此问题的步骤：
一、更换 Termux 国内镜像源
Termux 默认源位于境外，国内用户常因网络限制导致 pkg update 失败、依赖下载中断或 install.sh 脚本超时。切换至稳定镜像源可显著提升安装成功率与速度。
1、打开 Termux 应用，确保已联网。
2、执行命令 termux-change-repo，按提示选择镜像站点（推荐清华 TUNA 或北外 BFSU）。
3、若命令不可用，手动替换 sources.list：执行 sed -i 's@^\(deb.*stable main\)$@#\1\ndeb https://mirrors.tuna.tsinghua.edu.cn/termux/apt/termux-main stable main@' $PREFIX/etc/apt/sources.list。
4、执行 pkg clean && pkg update 验证源是否生效，确认输出中无 404 或 connection refused 错误。
二、使用官方一键安装脚本
该脚本自动识别 Termux 环境，适配 Android API 级别，安装预编译依赖并配置 PATH，适合绝大多数未 Root 设备。
1、确保已完成镜像源切换及 pkg update。
2、执行安装命令：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash。
3、等待脚本完成（约 30–60 分钟），期间勿关闭 Termux 或锁屏。
4、安装结束后，执行 hermes --version 检查是否输出版本号（如 hermes 0.12.3）。
三、手动分步安装（适用于脚本失败或需定制）
当一键脚本因网络中断、Rust 编译失败或 jiter/maturin 报错而终止时，可跳过自动构建环节，采用纯 Python 方式部署核心功能。
1、安装基础工具链：pkg update && pkg install -y git python python-pip pkg-config libffi openssl nodejs ripgrep ffmpeg。
2、克隆仓库（含子模块）：git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git && cd hermes-agent。
3、创建并激活 Python 3.11 虚拟环境：python -m venv venv311 && source venv311/bin/activate。
4、设置 Android API 级别变量：export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"。
5、安装约束版依赖（避免版本冲突）：pip install -e '.[termux]' -c constraints-termux.txt。
6、创建全局命令链接：ln -sf "$PWD/venv311/bin/hermes" "$PREFIX/bin/hermes"。
四、ARM 架构兼容性补丁（针对 jiter 报错）
Termux 在 ARM64-v8a 设备（如骁龙 8 Gen2+）上无法原生编译 Rust 包 jiter，导致 hermes doctor 提示 ImportError。需注入纯 Python 兼容桩替代原生模块。
1、确认报错现象：运行 hermes doctor 后出现 ModuleNotFoundError: No module named 'jiter' 或类似 Rust 编译失败日志。
2、进入虚拟环境 site-packages 目录：cd venv311/lib/python3.11/site-packages/。
3、创建 jiter.py 桩文件：cat > jiter.py 。
4、验证补丁生效：退出并重新进入虚拟环境后，执行 python -c "import jiter; print(jiter.from_json('{}'))"，应输出空字典而非报错。
五、存储权限与初始化配置
Hermes Agent 需访问本地文件系统以读写 MEMORY.md、USER.md 及技能定义，未授权将导致配置失败或记忆丢失。
1、在 Termux 中执行 termux-setup-storage，授予存储访问权限（弹窗点击“允许”）。
2、首次运行 hermes，将自动进入交互式 setup 向导。
3、按提示输入模型提供商（如 OpenRouter、Anthropic）及对应 API Key，务必确认 Key 格式正确且未包含多余空格。
4、完成配置后，系统自动生成 ~/.hermes/config.yaml，并提示 “Setup complete. You can now run ‘hermes’ anytime.”。
