Skip to main content

Android / Termux

注意：本指南适用于在 Android 设备上使用 Termux 运行 Hermes Agent。由于硬件限制，建议使用性能较强的设备（如 Pixel 6/7/8、OnePlus 9/10/11 等）以获得最佳体验。

📱 前置准备​

1. 安装 Termux​

  • 从 F-Droid 或 GitHub Releases 下载并安装 Termux。
  • 安装后首次启动时，请按提示完成初始化（设置密码、更新包列表等）。

2. 更新系统包​

pkg update && pkg upgrade -y

3. 安装必要依赖​

pkg install git python curl wget jq unzip tar -y

🔧 安装与配置 Hermes Agent​

1. 克隆 Hermes Agent 仓库​

git clone https://github.com/agent-hub/hermes-agent.git
cd hermes-agent

2. 创建 Python 虚拟环境​

python -m venv venv
source venv/bin/activate

3. 安装依赖​

pip install -r requirements.txt

⚠️ 如果遇到 pip 错误，尝试：

python -m pip install --upgrade pip

🛠️ 配置环境变量​

创建 .env 文件并配置 API 密钥：

touch .env
echo "OPENAI_API_KEY=your-openai-key" >> .env
echo "OPENROUTER_API_KEY=your-openrouter-key" >> .env
echo "HONCHO_API_KEY=your-honcho-key" >> .env

💡 提示：

  • 可选使用 OpenRouter（免费且支持多种模型）
  • 若无密钥，可暂时留空，但部分功能将受限

🚀 启动 Hermes Agent​

方法一：直接运行（推荐用于测试）​

python main.py

方法二：后台运行（适合长期使用）​

nohup python main.py > hermes.log 2>&1 &

✅ 查看日志：

tail -f hermes.log

🎮 使用方式​

启动后，Hermes Agent 将进入交互模式，支持以下操作：

  • 输入自然语言指令（如“帮我写一封邮件”）
  • 自动调用工具（文件读写、网络搜索、代码生成等）
  • 多轮对话与上下文记忆

📌 常见问题解决​

问题解决方案
ModuleNotFoundError检查是否已激活虚拟环境 source venv/bin/activate
Permission denied确保文件有执行权限：chmod +x main.py
内存不足崩溃关闭其他应用，或降低模型复杂度（如使用 gpt-3.5-turbo）
网络连接失败检查网络权限，确保 Termux 已授权网络访问

📦 高级技巧​

1. 使用本地模型（需更强设备）​

# 安装 llama.cpp 支持
pkg install cmake make gcc -y
git clone https://github.com/ggerganov/llama.cpp.git
cd llama.cpp && make

2. 设置自动启动（开机自启）​

# 编辑 Termux 的启动脚本
nano ~/.termux/boot/start_hermes.sh

添加内容：

#!/data/data/com.termux/files/usr/bin/sh
cd /data/data/com.termux/files/home/hermes-agent
source venv/bin/activate
nohup python main.py > /data/data/com.termux/files/home/hermes.log 2>&1 &

赋予执行权限：

chmod +x ~/.termux/boot/start_hermes.sh

🌐 社区支持​

✅ 总结​

步骤操作
1安装 Termux 并更新
2安装 Python 和依赖
3克隆 Hermes Agent 项目
4配置 .env 文件
5启动 python main.py
6开始与 AI 代理对话

🎯 现在你已成功在 Android 上运行了 Hermes Agent！
未来可扩展为手机端的智能助手、自动化工作流中枢。

📝 提示：若想进一步集成 Telegram、WhatsApp、Slack 等平台，请参考官方文档中的 MCP（Multi-Channel Protocol）模块。

✅ 现在就动手试试吧！
让你的安卓手机变成一个强大的 AI 代理终端。"​

在 Android 上通过 Termux 运行 Hermes

这是经过验证的路径，可在 Android 手机上直接通过 Termux 运行 Hermes Agent。

它为你的手机提供一个可工作的本地 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 的 wheel 包
  • Termux 安装程序会跳过自动浏览器 / Playwright 启动流程
  • Docker 基于的终端隔离功能在 Termux 中不可用

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

方案一：一键安装器​

Hermes 现已提供对 Termux 友好的安装路径：

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

在 Termux 中，该安装器会自动执行以下操作：

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

如果你希望查看详细命令，或需要排查安装失败问题，请使用下方的手动安装方式。

方案二：手动安装（完全显式）​

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

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

为何需要这些包？

  • python — 运行时 + 虚拟环境支持
  • 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

如果你只需要最小化的核心代理，也可以这样安装：

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 中设置密钥。

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

hermes setup

手动安装可选的 Node 依赖​

经过验证的 Termux 路径有意跳过了 Node/浏览器启动流程。如果你想后续进行实验：

npm install

请将 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 上失败​

请使用 Termux 路径，并配合标准库虚拟环境 + 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

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

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
  • 完整的安装命令和错误输出