安装hermes agent v0.18.2卡在依赖下载环节，本质是github、pypi、npmjs.org等源站国内直连受阻，需前置配置git、pip、npm三路镜像，并推荐使用modelscope定制安装脚本。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
安装 Hermes Agent v0.18.2 时卡在依赖下载环节，常见于 pip、npm、git clone 等步骤长时间无响应或超时失败，本质是 GitHub、PyPI、npmjs.org 等源站在国内直连质量差，不是网络本身问题，而是路径受阻导致 uv、Node.js、Python 包反复重试甚至中断。
提前配置全局镜像（必须前置）
这一步必须在运行任何安装命令前完成，否则安装脚本启动后会直接拉取原始源，错过加速窗口。
执行以下三条命令，一次性打通 Git、pip、npm 三路通道：
git config --global url."https://mirror.ghproxy.com/https://github.com".insteadOf "https://github.com"
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/ && pip config set install.trusted-host mirrors.aliyun.com
npm config set registry https://mirrors.cloud.tencent.com/npm/ --global
【注意：这三步缺一不可，且必须用当前用户权限执行，不要加 sudo】 否则安装脚本以普通用户身份运行时，将读不到 root 下的配置，仍走原始慢速通道。
替换官方安装脚本 URL（推荐首选）
官方一键脚本 curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash 内部仍会调用 raw.githubusercontent.com 和 pypi.org，直接换用已预置国内镜像逻辑的定制版安装地址：
复制并执行：
curl -sSL "https://modelscope.cn/datasets/aifengheguai/hermes-agent-v0.18.2/resolve/master/install.sh" | sudo bash
该脚本由 ModelScope 社区维护，已将 APT 源、Docker 镜像加速、uv 缓存路径、PyPI/npm/Git 代理全部内嵌，适配 Ubuntu 22.04+ 及 WSL2 环境，无需额外干预即可跳过 90% 的网络卡顿点。
手动指定 uv 和 pip 镜像（备用方案）
若你已开始安装但中途卡住，或想验证当前环境是否生效，可临时覆盖环境变量强制走镜像：
方法一：临时注入 pip 镜像
在安装命令前加一行：export PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/
然后继续执行原安装命令，例如：export PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/ && curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
方法二：强制 uv 使用阿里云源
uv 是 Hermes v0.18.2 默认的 Python 包管理器，它不读 pip config，需单独设变量：export UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/
【关键点：UV_INDEX_URL 必须大写，且等号前后不能有空格，否则 uv 完全忽略】
方法三：跳过 Node.js 二进制下载（Jetson Nano / Ubuntu 18.04 等旧系统专用）
某些设备因 glibc 版本低无法运行 Node.js v22 官方二进制，安装脚本会卡在下载环节。此时可改用源码编译方式：
先执行：curl -fsSL https://ghproxy.net/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | sed 's/nodejs_binary_install=true/nodejs_binary_install=false/g' | bash
该命令用 sed 动态屏蔽 Node.js 二进制下载逻辑，让脚本转而使用系统已有 Node.js 或通过 uv 构建轻量运行时。
验证加速是否生效
第一步：检查 uv 缓存是否命中镜像
安装完成后，运行：uv pip install --dry-run requests
观察输出中是否有 https://mirrors.aliyun.com/pypi/simple/requests/ 字样——有则说明 UV_INDEX_URL 生效。
第二步：确认 git clone 是否走代理
进入 ~/.hermes/ 目录，执行：git remote -v
应看到 origin 地址为 https://mirror.ghproxy.com/https://github.com/NousResearch/hermes-agent.git，而非原始 github.com 地址。
第三步：测试 npm 源切换
运行：npm config get registry，输出应为 https://mirrors.cloud.tencent.com/npm/。
