在国内网络环境下安装hermes agent需配置国内镜像源：执行四条命令替换git、pip、npm全局源；使用gitee优化脚本替代官方install.sh；或手动克隆+分步安装并指定清华pypi源和淘宝node镜像。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在国内网络环境下安装 Hermes Agent 时，执行官方脚本常因 GitHub 克隆超时、PyPI 包下载卡死、npm 依赖拉取失败而中断，整个过程可能持续数小时甚至失败——这不是你的网络问题，而是默认源全部指向境外服务器。
一键启用国内镜像加速
运行以下命令，直接替换全局 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://pypi.tuna.tsinghua.edu.cn/simple
pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn
npm config set registry https://registry.npmmirror.com --global
这四条命令必须一次性执行完成，【缺一不可】。漏掉 npm 或 pip 配置，后续安装仍会卡在对应环节。
使用优化版安装脚本（推荐）
官方 install.sh 脚本硬编码了境外地址，直接运行必然失败。请用国内镜像优化版替代：
curl -fsSL https://gitee.com/hermes-agent-mirror/install/raw/main/install.sh | bash
该脚本已将 GitHub 仓库地址、uv 安装源、Node.js 二进制包、Python 依赖源、Termux 镜像等全部切换为清华、阿里云、腾讯云等国内节点。它不依赖 GitHub 原始仓库，也不走原始 PyPI 网络路径。
注意：Gitee 链接需确保你已登录 Gitee 账号并授权访问公开仓库；若提示 404，请检查链接末尾是否多出空格或换行符。
手动克隆 + 源码安装（备用方案）
当脚本方式仍不稳定时，可分步控制每个环节：
第一步：用镜像地址克隆代码
git clone https://mirror.ghproxy.com/https://github.com/NousResearch/hermes-agent.git
第二步：进入目录并切换分支
cd hermes-agent → git checkout main
第三步：强制使用清华 PyPI 源安装 Python 依赖
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
第四步：指定淘宝 Node 镜像安装前端依赖
NODE_MIRROR=https://npm.taobao.org/mirrors/node npm install
这一步必须在项目根目录下执行，【NODE_MIRROR 环境变量仅对当前命令生效】，不能写成 export NODE_MIRROR=... 后再 run npm install，否则无效。
