需更换termux软件源为grimler.se并更新，再安装python、rust、ffmpeg等依赖，最后通过一键脚本或手动方式安装hermes agent，验证后运行hermes setup配置api密钥。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在安卓手机上运行 Hermes Agent，但 Termux 环境尚未配置或安装失败，则可能是由于依赖未更新、源不可达或安装路径异常所致。以下是解决此问题的步骤：
一、准备 Termux 环境并修复软件源
Termux 默认镜像可能因网络策略导致连接超时，需手动更换为稳定可用的源，确保后续所有包安装顺利进行。此步骤是整个安装流程的基础前提，跳过将直接引发后续命令失败。
1、打开 Termux 应用，等待出现 $ 提示符。
2、执行命令编辑软件源列表：nano $PREFIX/etc/apt/sources.list。
3、删除原有内容，粘贴以下行：deb https://grimler.se/termux/termux-main/ stable main。
4、按 Ctrl+O → Enter → Ctrl+X 保存退出。
5、执行更新命令：pkg update && pkg upgrade -y。
二、安装基础依赖与运行时组件
Hermes Agent 在 Termux 中依赖 Python、Rust 编译工具链及媒体处理能力，必须显式安装对应包，否则 pip 安装阶段会因缺少 clang、libffi 或 ffmpeg 而中断。
1、执行依赖安装命令：pkg install -y git python clang rust make pkg-config libffi openssl nodejs ripgrep ffmpeg。
2、验证 Python 版本是否为 3.11+：python --version。
3、如需调用摄像头或传感器（如微信扫码登录），额外安装：pkg install termux-api。
三、执行官方一键安装脚本
该脚本自动拉取最新代码、创建虚拟环境、安装 Python 包及 Termux 兼容组件，适用于绝大多数未 root 的安卓设备，无需手动克隆仓库。
1、确保已执行 source ~/.bashrc（若此前未运行，会导致 hermes 命令不可识别）。
2、粘贴并执行安装命令：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash。
3、等待脚本完成，过程中会自动处理 Python 依赖、Node.js 工具及 Hermes CLI 注册。
4、安装结束后，立即运行：source ~/.bashrc，使新命令生效。
四、手动安装（当一键脚本失败时）
若网络不稳定或 GitHub 子模块递归失败，可跳过脚本，改用本地构建方式。此方法绕过远程脚本执行限制，对代理环境更友好。
1、克隆项目仓库：git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git。
2、进入目录：cd hermes-agent。
3、创建并激活虚拟环境：python -m venv venv && source venv/bin/activate。
4、设置 Android API 级别变量：export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"。
5、安装 Termux 专用组件：python -m pip install -e '.[termux]' -c constraints-termux.txt。
6、创建全局命令链接：ln -sf "$PWD/venv/bin/hermes" "$PREFIX/bin/hermes"。
五、验证安装与初始化配置
安装完成后需确认核心依赖可被识别，并完成模型提供商绑定，否则无法启动交互式会话。此阶段不涉及模型下载，仅校验环境连通性与配置入口可用性。
1、运行诊断命令：hermes doctor，检查 ripgrep、Node、Python 模块是否全部通过。
2、若提示缺失 Node 或 ripgrep，重新执行 pkg install nodejs ripgrep 并重试。
3、启动交互式配置：hermes setup，按提示选择模型供应商（如 OpenRouter、Nous Portal）并输入对应 API Key。
4、配置完成后，直接运行：hermes，观察是否进入 CLI 交互界面并显示欢迎信息。
