若Linux安装Hermes Agent时卡在git clone或报unexpected eof，主因是GitHub网络受限；可选三种方案：一、官方脚本+离线源码补救法；二、手动分步构建法；三、WSL2专项适配法。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在 Linux 系统上安装 Hermes Agent，但执行官方一键脚本后卡死在 git clone 步骤或报 unexpected eof 错误，则很可能是因 GitHub 源码拉取受网络限制所致。以下是多种可行的安装部署步骤：
一、官方脚本+离线源码补救法
该方法复用官方 install.sh 的环境自动配置能力，在其触发 GitHub 克隆前中断流程，再将已下载的完整源码包解压至指定路径，规避网络不稳定问题。
1、访问百度网盘链接 https://pan.baidu.com/s/1PMVQ4bANEhyie94IbRQ5GQ?pwd=9dbu，下载 install.sh 与 hermes-agent-main.zip 两个文件，并保存至用户主目录（即 ~ 路径）。
2、在终端中执行：chmod +x ~/install.sh，赋予脚本可执行权限。
3、运行脚本：~/install.sh，当输出出现类似 “Cloning into 'hermes-agent'…” 提示时，立即按 Ctrl+C 中断执行。
4、创建目标目录：mkdir -p ~/hermes-agent。
5、解压离线包：unzip ~/hermes-agent-main.zip -d ~/hermes-agent（若未安装 unzip，请先执行 sudo apt install unzip）。
6、进入目录并完成后续安装：cd ~/hermes-agent && uv pip install -e ".[all]"。
二、手动分步构建法
该方法完全绕过官方脚本，由用户自主控制每一步依赖安装与环境初始化，适合对系统有明确控制需求或需定制功能模块的用户。
1、确保已安装 Git：git --version；如无输出，请执行 sudo apt update && sudo apt install git（Ubuntu/Debian）。
2、安装 uv 包管理器：curl -LsSf https://astral.sh/uv/install.sh | sh。
3、创建 Python 3.11 虚拟环境：uv venv venv --python 3.11。
4、激活虚拟环境：source venv/bin/activate。
5、克隆仓库（若网络可用）：git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git；若失败，可改用离线 zip 包解压至当前目录并重命名为 hermes-agent。
6、进入项目目录：cd hermes-agent。
7、安装全部功能模块：uv pip install -e ".[all]"；如仅需核心功能，替换为 uv pip install -e "."。
三、WSL2 环境专项适配法
该方法专为 Windows 用户通过 WSL2 部署设计，重点解决子系统内 DNS 解析异常、权限模型冲突及 systemd 缺失导致的 gateway 启动失败问题。
1、在 Windows 上启用 WSL2 并安装 Ubuntu 发行版（推荐 22.04 或更新版本）。
2、启动 WSL2 终端，执行：sudo apt update && sudo apt install -y curl git unzip wget。
3、关闭 WSL2 的默认 systemd 支持（避免冲突），在 Windows PowerShell 中运行：wsl --shutdown，然后编辑 WSL 配置文件 %USERPROFILE%\AppData\Local\Packages\
4、重启 WSL2，执行离线安装流程（同方法一），并在安装完成后运行：echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc。
5、验证命令可用性：hermes --version。
