🤖HermesBlog
Hermes 官方教程 · 第11篇2026/8/9· Easy Understand Hermes Agent

第十一篇:手机也能跑 Hermes——安卓 Termux 安装指南

Hermes Agent 官方教程第十一篇:在安卓手机上用 Termux 安装运行 Hermes,随时随地指挥 AI。

这篇教程将手把手教你如何在安卓手机上通过 Termux 安装 Hermes Agent,让你的手机变成随身携带的 AI 智能体终端。

准备工作:什么是 Termux?

想象一下,Termux 就是手机里的一个“终端模拟器”,它能在安卓系统上搭建一个类似 Linux 的小环境,让你像在电脑上一样运行各种命令行工具。Hermes 可以跑在这个环境里,让你的手机秒变 AI 助手工作站。

注意:Termux 属于“第二梯队”平台,官方会尽力维护,但可能偶尔出现兼容性问题,请保持耐心。

安装方式一:一键安装(推荐新手)

就像手机装 App 一样简单,打开 Termux 后输入:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

这个安装脚本会自动完成所有工作:安装系统包、创建虚拟环境、配置路径,还会自动跳过不兼容的组件。装完后直接输入 hermes 就能启动。

安装方式二:手动安装(适合喜欢掌控的用户)

第 1 步:更新系统并安装依赖

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

这些包就像是做菜的“食材”——python 是主料,clangrust 是“锅铲”(编译工具),ffmpeg 用来处理多媒体。

第 2 步:获取 Hermes 源码

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

第 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 很关键,它告诉编译工具你的安卓版本,避免后续出错。

第 4 步:安装测试过的组件包

python -m pip install -e '.[termux]' -c constraints-termux.txt

这套组件包含 CLI、定时任务、Telegram 网关、MCP 支持等核心功能。

第 5 步:让 hermes 命令全局可用

ln -sf "$PWD/venv/bin/hermes" "$PREFIX/bin/hermes"

这样以后打开新终端直接输入 hermes 就能用,不用每次激活环境。

第 6 步:验证安装

hermes version
hermes doctor

doctor 会像体检一样检查各项功能是否正常。

第 7 步:启动!

hermes

后续配置

  • 运行 hermes model 配置 AI 模型,或在 ~/.hermes/.env 里直接设置密钥
  • 想重新配置就运行 hermes setup
  • 想试试浏览器自动化?手动安装:pkg install nodejs-lts 然后 npm install

常见问题速查

  • 安装失败:确认已安装编译工具链,并设置好 ANDROID_API_LEVEL
  • 缺少组件pkg install ripgrep nodejs 补装即可
  • 语音功能不可用:这是正常现象,faster-whisper 不支持安卓

手机端限制

Docker 隔离、本地语音转写、浏览器自动化在手机上暂不可用。但作为随身 CLI 智能体,Hermes 在手机上的表现已经足够惊艳!


总结:通过 Termux,你的安卓手机就能变成 Hermes 的移动终端。虽然有些高级功能受限,但核心体验完整,适合随时随地进行 AI 对话和任务处理。

下篇预告:装好了 Hermes,下一步自然是让它真正“跑起来”!下一篇我们将深入 Hermes 的配置世界,教你如何选择模型、设置 API 密钥,以及用 hermes setup 完成个性化定制。敬请期待!

📖 官方文档

本文根据 Hermes Agent 官方文档编写,原文见:官方文档 › getting-started/installation