HERMES_AGENT_PIXEL_SETUP.md 7.85 KB

Edit Raw Blame History


在 Pixel 上编译安装 hermes-agent + 配置 Kimi Coding Plan

目标设备：Pixel 8 Pro (husky)，Android 16，已 root（Magisk）+ Termux。
hermes-agent = NousResearch 的自改进 AI agent（github.com/NousResearch/hermes-agent，Python 3.11+/Node），提供 hermes CLI（hermes 聊天 / hermes gateway 消息网关 / hermes setup 配置）。本文记录从 Mac 经 adb 把它装到 Pixel Termux，并接 Kimi Coding Plan 作为 LLM 后端的完整流程。

相关记忆：~/.claude/.../memory/hermes-agent-termux-install.md、magisk-su-android-inet-group.md、termux-path-convention.md。


0. 前置

设备已 root，Termux 已装（GitHub/F-Droid 版，非 Play 商店）。Termux 重装/设备 restore 后 uid 会变，先取当前 uid：
bash
adb shell 'su -c "stat -c %u /data/data/com.termux"'   # 例：10302（low3 = 302）

所有「以 Termux 用户身份联网」的命令必须带 inet 等 supplementary group，否则 DNS/网络全断。统一模板（uid=10302 为例）：

su -g 10302 -G 3003 -G 9997 -G 20302 -G 50302 10302 -c "<cmd>"

其中 3003=inet 9997=everybody 20<low3>=cache 50<low3>=all_aN。详见 memory magisk-su-android-inet-group。
Termux 环境变量（脚本里统一 export）：
bash
export PREFIX=/data/data/com.termux/files/usr
export HOME=/data/data/com.termux/files/home
export PATH=$PREFIX/bin:$PATH
export LD_LIBRARY_PATH=$PREFIX/lib
export TMPDIR=$PREFIX/tmp
export TERMUX_VERSION=0.118.3


1. 编译安装 hermes-agent
官方安装器原生支持 Termux：检测到 Termux 后用 stdlib venv+pip（不用 uv），自动 pkg install python/git/nodejs/clang/rust/ffmpeg/ripgrep，从源码编译 native wheel（maturin / pydantic-core / jiter…），装到 ~/.hermes/hermes-agent/venv，并在 $PREFIX/bin/hermes 建 wrapper。整机编译约 25–30 分钟。
1.1 ⚠️ 必做：先升级 Termux 全量包（否则 node 坏）
全新 bootstrap 过期时，pkg install nodejs 装上的 node 链不上旧 openssl：
node: CANNOT LINK EXECUTABLE "node": cannot locate symbol "OSSL_PROVIDER_add_conf_parameter"


install.sh 因 set -e 在 Node 步骤 rc=1 退出。先升级再装：
export DEBIAN_FRONTEND=noninteractive
apt-get update -y
apt-get upgrade -y -o Dpkg::Options::=--force-confold -o Dpkg::Options::=--force-confdef
node --version   # 应能正常打印版本（不再 CANNOT LINK）

1.2 跑安装器（脱离 + 日志，扛 adb 掉线/doze）
把下面脚本 push 到 /sdcard，再以 Termux 用户 setsid nohup 脱离运行：
#!/data/data/com.termux/files/usr/bin/bash
# 见上方 export 块……
export DEBIAN_FRONTEND=noninteractive
cd "$HOME"; termux-wake-lock 2>/dev/null || true
echo "=== UPGRADE START $(date) ==="
apt-get update -y; apt-get upgrade -y -o Dpkg::Options::=--force-confold -o Dpkg::Options::=--force-confdef
node --version || { echo "NODE BROKEN"; exit 2; }
echo "=== HERMES INSTALL $(date) ==="
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --non-interactive
echo "=== HERMES INSTALL END rc=$? $(date) ==="

adb push install.sh /sdcard/install.sh
LOG=/data/data/com.termux/files/home/hermes-install.log
adb shell "su -g 10302 -G 3003 -G 9997 -G 20302 -G 50302 10302 -c \
  'setsid nohup /data/data/com.termux/files/usr/bin/bash /sdcard/install.sh >$LOG 2>&1 </dev/null & echo pid \$!'"
# 轮询：grep 'HERMES INSTALL END rc=0' $LOG


--non-interactive 跳过 setup 向导（无 TTY 也能跑）。
1.3 ⚠️ 必做：修 wrapper shebang
installer 生成的 $PREFIX/bin/hermes 首行是 #!/usr/bin/env bash。Termux 没 /usr/bin/env，交互会话靠 termux-exec 动态改写，但用 su -c 驱动（无 termux-exec）会报 No such file or directory（指解释器）。改成绝对路径（以 Termux 用户改，保留属主）：
adb shell "su 10302 -c 'sed -i \"1s|#!/usr/bin/env bash|#!/data/data/com.termux/files/usr/bin/bash|\" /data/data/com.termux/files/usr/bin/hermes'"


注意：hermes update 会重新生成 wrapper、把 shebang 改回 /usr/bin/env，每次更新后需重修。
venv/bin/hermes 的 shebang 是绝对 venv python，本就没问题，可用它绕过 wrapper 验证。

1.4 验证
adb shell 'su -g 10302 -G 3003 -G 9997 -G 20302 -G 50302 10302 -c "
  export PREFIX=/data/data/com.termux/files/usr HOME=/data/data/com.termux/files/home
  export PATH=\$PREFIX/bin:\$PATH LD_LIBRARY_PATH=\$PREFIX/lib TMPDIR=\$PREFIX/tmp
  hermes --version"'
# → Hermes Agent v0.15.1 (2026.5.29) · Python 3.13.13


产物位置：代码 ~/.hermes/hermes-agent/，配置 ~/.hermes/config.yaml + ~/.hermes/.env，skills ~/.hermes/skills/。


2. 配置 Kimi Coding Plan（sk-kimi- key）
hermes 原生支持 Kimi Coding Plan，不要用 provider=anthropic+ANTHROPIC_BASE_URL 绕路。
2.1 源码逻辑（为什么这么配）


文件
逻辑


hermes_cli/auth.py:248
kimi-coding provider：api_key_env_vars=("KIMI_API_KEY","KIMI_CODING_API_KEY")


hermes_cli/auth.py:515
KIMI_CODE_BASE_URL = "https://api.kimi.com/coding"；_resolve_kimi_base_url() 把 sk-kimi- 前缀 key 自动重定向到这里


agent/anthropic_adapter.py:385
_is_kimi_coding_endpoint(base_url) 检测到 api.kimi.com/coding → 自动切 Anthropic Messages 协议 + 注入 claude-code User-Agent


hermes_cli/main.py _model_flow_kimi()
setup 向导：写 model.provider/base_url/default，清空 KIMI_BASE_URL override


关键坑：Kimi /coding 端点的 OpenAI 路径 /coding/v1/chat/completions 返回 403 access_terminated_error（"only available for Coding Agents such as Kimi CLI, Claude Code, Roo Code…"）；只有 Anthropic 路径 /coding/v1/messages 通（200）。hermes 通过上面的 UA 伪装自动绕过，所以必须走 kimi-coding provider（anthropic 协议），不能用 OpenAI 协议。
2.2 落地配置（等价于 hermes model 选 Kimi）
~/.hermes/.env：只放 key，不要设 KIMI_BASE_URL，也别留 ANTHROPIC_*（否则 provider: auto 会误判）：
KIMI_API_KEY=sk-kimi-XXXXXXXX...


用 cat /sdcard/x >> .env（root 追加不改属主）或 su <uid> -c 'sed ...'（Termux 用户改，保属主）避免把 key 写进命令行/ps。


~/.hermes/config.yaml（用 CLI 设，非交互）：
hermes config set model.provider kimi-coding
hermes config set model.base_url https://api.kimi.com/coding
hermes config set model.default  kimi-for-coding


可用模型：kimi-k2.6 / kimi-k2.5 / kimi-for-coding / kimi-k2-thinking / kimi-k2-thinking-turbo。
2.3 验证
# -z/--oneshot = 一次性 prompt，免 TTY
hermes -z "用中文只回答一个数字: 1+1=?"
# → 2


裸 hermes（不带 -m/--provider）直接走 Kimi 即配置成功。
2.4 排错速查


现象
原因 / 处理


HTTP 404 resource not found
base_url 漏了协议路径或用了 provider=anthropic+错 base；改用 kimi-coding + https://api.kimi.com/coding


HTTP 403 access_terminated_error
走了 OpenAI /chat/completions 路径；必须 kimi-coding（anthropic 协议，hermes 自动加 claude-code UA）


no final response was produced
config 残留错的 model.base_url（如 openrouter）或 provider 不对；按 2.2 重设三项


curl: Could not resolve host
su 切 uid 时漏了 -G 3003（inet 组）


附：一次性自检脚本
adb shell 'su -g 10302 -G 3003 -G 9997 -G 20302 -G 50302 10302 -c "
  export PREFIX=/data/data/com.termux/files/usr HOME=/data/data/com.termux/files/home
  export PATH=\$PREFIX/bin:\$PATH LD_LIBRARY_PATH=\$PREFIX/lib TMPDIR=\$PREFIX/tmp
  hermes --version
  hermes config show | grep -iE \"provider|default|base_url\"
  hermes -z \"ping, reply PONG\"
"'