离线部署hermes agent需在外网机打包python运行时、uv二进制、源码及wheel依赖，再在内网机解压、禁用联网脚本、手动构建虚拟环境并安装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在没有外网连接的服务器或内网环境中部署 Hermes Agent，必须跳过所有联网行为，包括 git clone、PyPI 下载、uv index 请求和 GitHub 源码拉取。离线安装的核心是把 Python 运行时、uv 二进制、源码包、wheel 缓存全部打包带入，再通过脚本改造与手动路径衔接完成初始化。
准备离线安装包（需在外网机器操作）
这一步必须在一台架构相同（如 x86_64）、能联网的 Linux 主机上完成，不能跳过。
第一步：创建工作目录并进入：mkdir -p ~/hermes-offline && cd ~/hermes-offline
第二步：下载官方 install.sh 脚本：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh -o install.sh
第三步：完整克隆源码（含子模块）：git clone --recursive https://github.com/NousResearch/hermes-agent.git hermes-agent-main
第四步：压缩源码为 zip：zip -r hermes-agent-main.zip hermes-agent-main
第五步：用 uv 构建离线 wheel 包。先创建虚拟环境：uv venv venv-offline --python 3.11，再激活并批量下载依赖：source venv-offline/bin/activate && uv pip wheel --no-deps --wheel-dir ./wheels --find-links ./wheels --no-index -r hermes-agent-main/requirements.txt。这一步耗时较长，但能确保所有依赖都落盘为本地 wheel 文件。
第六步：提取 Python 3.11 嵌入式运行时。若 uv 环境中未自带，需额外下载 python-3.11-embed-amd64.zip（Windows）或 Python-3.11.9.tgz（Linux），解压后取 bin/python 或 python.exe。Linux 下可直接从 venv-offline/bin/python 复制，【必须确认该 python 可执行且能跑 import sys; print(sys.version)】。
第七步：打包全部资源：tar -czf hermes-offline-bundle.tgz install.sh hermes-agent-main.zip wheels/ venv-offline/bin/python。注意不要包含整个 venv 目录，只取可执行文件即可，否则体积暴增且易出错。
在离线机器上执行安装
上传 hermes-offline-bundle.tgz 到目标机器的用户主目录（如 /root 或 /home/admin），然后逐项执行以下操作。
解压离线包：tar -xzf hermes-offline-bundle.tgz
修改 install.sh，在第一行插入 exit 0，或者定位到 git clone 所在行，在其上方加 exit 0。这一步是为了让脚本在联网动作前强制终止，【不加 exit 0 将导致脚本卡死或报错退出，无法继续后续手动补位】。
赋予执行权限：chmod +x install.sh
运行脚本：./install.sh。它会快速创建 ~/.hermes 目录结构并退出，不拉取任何远程内容。
手动解压源码：unzip hermes-agent-main.zip -d ~/.hermes/src/。注意目标路径必须是 ~/.hermes/src/，这是 Hermes 启动时默认查找的位置，填错会导致 hermes start 报 “No module named hermes”。
构建并激活 Python 环境
方法一：使用自带 python 二进制（推荐）
进入源码目录：cd ~/.hermes/src/hermes-agent-main
用 uv 创建干净虚拟环境：~/hermes-offline/venv-offline/bin/python -m venv ~/.hermes/venv
激活环境：source ~/.hermes/venv/bin/activate
安装本地 wheel：pip install --find-links ../wheels --no-index -r requirements.txt
以开发模式安装 Hermes：pip install -e .
方法二：复用离线包中预编译的 uv 二进制
如果离线包中已含 uv 二进制（如 uv-x86_64-unknown-linux-musl），直接赋权运行：chmod +x uv && ./uv venv ~/.hermes/venv --python=3.11
然后激活并安装：source ~/.hermes/venv/bin/activate && pip install -e . --find-links ../wheels --no-index
验证与启动
执行 hermes --version。若输出版本号（如 hermes 0.7.2），说明命令已注册成功。
运行 hermes setup，在模型提供商选项中选择 Ollama（纯离线）或跳过 API 配置直接进入 CLI 模式。
启动服务：hermes start。终端应显示 Agent server listening on http://localhost:8000，表示离线部署完成。
