Hermes Agent install.sh 下载失败、卡住、超时怎么办

先分清是哪一段在卡

官方一键安装命令只有一行,但它背后串了好几段下载:先下载 install.sh 脚本本身;脚本再去 github.com clone Hermes 的代码仓库;然后从 astral.sh 下载 uv,用它装 Python,从 nodejs.org 下载 Node.js,再装 Playwright 浏览器;最后拉 Python 依赖。国内网络下这几段会在不同的位置卡住,解法也不一样。不分清就开始换镜像、配代理,基本是乱试。

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

判断方法:先把 | bash 去掉,单独下一次脚本,把它落到本地文件:

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

第一条几秒内拿到文件,说明脚本下载这段是通的;第一条就转半天、超时退出,卡点在最前面。第二条在本地执行脚本,看它停在哪一步:停在 clone 仓库,是 GitHub 那跳不通;停在下载 uv、Python、Node.js 或浏览器,是那几个境外下载源不通;停在装 Python 包,才是 PyPI 那段慢。官网新地址访问不畅时,旧地址 https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh 也还能用,内容一样。

最稳的解法:给整个终端配代理

clone 仓库、下载 uv 和 Node.js 这几段都要访问境外地址,所以最省事的是给当前终端配上你自己的 HTTP 代理,curl、git 和安装脚本里的下载都会走它:

export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

端口换成你本机代理实际监听的端口,别照抄 7890。export 出来的代理只对当前这个终端窗口有效,新开一个窗口就没了,所以从下载到装依赖、跑验收,尽量在同一个终端里一口气做完。

用 GitHub 加速服务做前缀,只能帮你把脚本本身下载下来;脚本跑起来之后 clone 仓库照样要直连 github.com,所以单靠加速前缀通常还是会卡在 clone 那一步。

用不到浏览器自动化的话,加 --skip-browser 可以跳过 Playwright 浏览器下载,少一段境外下载:

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

依赖拉取这段:可以试试国内 PyPI 镜像

脚本跑到装 Python 包这一步一直转圈,是依赖源走了境外。安装器用 uv 管理 Python 依赖,可以给它指一个国内 PyPI 镜像:

export UV_DEFAULT_INDEX=https://pypi.tuna.tsinghua.edu.cn/simple
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

两点要注意:一是只能用环境变量,安装脚本设置了 UV_NO_CONFIG=1,写进 uv 的配置文件 uv.toml 不会生效;二是镜像同步有延迟,个别新发布的依赖可能暂时拉不到,遇到依赖解析失败就去掉这行,改用上面的代理方案。代理和镜像可以叠加使用。想长期带着镜像设置,可以把这行 export 写进 shell 配置文件(~/.bashrc 或 ~/.zshrc)。

装完先验收,别急着配模型

无论上面走了哪条路,装完只确认一件事:CLI 能起来、依赖齐了。这一步不通,后面配什么都白搭。

hermes --version
hermes doctor
hermes status

三条各管一段:hermes --version 确认命令本身在、版本号能正常打印;hermes doctor 检查配置和依赖是否齐全,缺什么会给出对应的安装命令,这是安装是否真的成功的硬指标;hermes status 给出所有组件的状态总览。三条都过,安装这关才算真过,而不是"脚本跑完没报错"就完事。

过了这关再去配模型——国内用户这一步顺手把默认 Provider 选成国内那几家(用 hermes model 交互式选,注意选带 China 的国内站选项),后面日常用起来就不必再为网络发愁。安装阶段的下载网络问题,和运行阶段连不连得上模型,是两件独立的事,别挤在一次折腾里。

一个常见的假象:脚本跑完不等于装好了

国内网络下还有一种坑人的情况:脚本看着跑完了、终端回到了提示符、也没刷红色报错,但其实中途某个依赖下载被跳过或截断了,装出来是个半成品。这种"假成功"光看脚本输出发现不了,只有靠上面那三条验收命令兜底。doctor 但凡报出缺这缺那,就说明刚才那次下载有东西没拉全,缺的是 Node.js、浏览器这类依赖时,可以用安装脚本的 --ensure 只补那几样(例如 bash -s -- --ensure node,browser),不用整个重装。判断一次安装到底成没成,认 doctor 的输出,别认脚本有没有报错。

还没有真实场景？可以先领取 Free Starter 模板包，从低风险只读任务开始试跑。