离线部署hermes agent需三步：一、在外网机打包install.sh、源码zip、wheel包及python环境；二、在离线机运行install.sh并中断网络步骤以初始化目录；三、注入源码与依赖，配置config.yaml后启动。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您需要在无外网连接的服务器或内网环境中部署 Hermes Agent，则无法直接执行官方在线安装脚本，因其依赖 GitHub 源码克隆、PyPI 包下载及 uv/Python 3.11 的远程获取。以下是解决此问题的步骤：
一、准备离线安装包
该方法通过预先在外网环境打包全部依赖与源码，再将完整资源迁移至目标离线机器，避免任何实时网络请求。需在一台可联网的同架构 Linux 主机（如 x86_64）上完成前置打包。
1、创建临时工作目录并进入：
mkdir -p ~/hermes-offline && cd ~/hermes-offline
2、下载官方安装脚本并保存为 install.sh：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh -o install.sh
3、手动克隆 Hermes-Agent 源码仓库（含子模块）：
git clone --recursive https://github.com/NousResearch/hermes-agent.git hermes-agent-main
4、压缩源码目录：
zip -r hermes-agent-main.zip hermes-agent-main
5、使用 uv 创建离线 Python 环境快照（需已安装 uv）：
uv venv venv-offline --python 3.11
source venv-offline/bin/activate
uv pip install --no-deps --only-binary=all -r hermes-agent-main/requirements.txt
uv pip wheel --no-deps --wheel-dir ./wheels --find-links ./wheels --no-index -r requirements.txt
6、将 install.sh、hermes-agent-main.zip、wheels/ 目录、venv-offline/ 中的 python 可执行文件及 site-packages 内容一并打包：
tar -czf hermes-offline-bundle.tgz install.sh hermes-agent-main.zip wheels/ venv-offline/bin/python venv-offline/lib/python3.11/site-packages/
二、在离线机器上执行环境初始化
该步骤复用官方 install.sh 的逻辑判断与路径配置能力，但跳过所有网络操作，仅完成目录结构创建、权限设置与基础符号链接生成。
1、将 hermes-offline-bundle.tgz 上传至离线机器的用户主目录（如 /root 或 /home/user）
2、解压离线包：
tar -xzf hermes-offline-bundle.tgz
3、赋予 install.sh 执行权限：
chmod +x install.sh
4、执行 install.sh 并强制中断其网络阶段（当输出出现 “Cloning Hermes-Agent…” 或 “Downloading uv…” 提示时立即 Ctrl+C）：
./install.sh
5、确认 ~/.local/bin/、~/.hermes/、~/.cache/hermes/ 等目录已被创建，且 ~/.hermes/venv 存在（即使为空）
三、注入离线源码与依赖
该步骤将预打包的源码和 wheel 包注入到 install.sh 初始化后的指定路径，使后续运行能完全脱离网络。
1、解压 hermes-agent-main.zip 到 ~/.hermes/ 目录下：
unzip hermes-agent-main.zip -d ~/.hermes/
2、重命名解压出的目录为 hermes-agent：
mv ~/.hermes/hermes-agent-main ~/.hermes/hermes-agent
3、激活离线 Python 环境并安装本地 wheel：
~/.hermes/venv/bin/python -m pip install --find-links ./wheels --no-index --upgrade --force-reinstall ./wheels/*.whl
4、验证依赖完整性：
~/.hermes/venv/bin/python -c "import uv, requests, pydantic; print('OK')"
四、配置模型与启动服务
该步骤绕过交互式向导中所有网络校验环节，直接写入最小可行配置，确保 agent 可启动并响应基础指令。
1、创建配置目录：
mkdir -p ~/.hermes/config
2、手动创建 config.yaml 文件：
cat > ~/.hermes/config.yaml model:
provider: custom
base_url: http://localhost:8000/v1
api_key: sk-offline-dummy
default: qwen-turbo
EOF
3、启动 Hermes Agent（不启用 gateway，仅 CLI 模式）：
~/.local/bin/hermes run --no-gateway
4、在新终端中测试基础功能：
echo "hello" | ~/.local/bin/hermes chat
