如何在离线环境中部署Hermes Agent Hermes Agent离线安装包制作

星明酱_1875

星明酱_1875

2026-04-12

1282人浏览

原创

离线部署Hermes Agent推荐使用预打包离线安装包:获取含install.sh、源码zip、uv二进制及Python3.11的离线包,修改脚本插入exit 0跳过git clone,解压源码至~/.hermes/src/,用uv创建虚拟环境并pip install -e . --find-links ./wheels --no-index安装。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如何在离线环境中部署hermes agent hermes agent离线安装包制作

如果您需要在无外网连接的服务器或内网环境中部署 Hermes Agent,则无法直接执行官方在线安装脚本,因其依赖 GitHub 源码拉取与 PyPI/uv 仓库下载。以下是实现离线部署的多种可行路径:

一、使用预打包离线安装包(推荐)

该方法基于官方 install.sh 脚本逻辑,但将所有远程依赖(uv、Python 3.11 运行时、hermes-agent 源码、pip 包缓存)预先整合为本地可执行资源,避免任何网络请求。

1、从可信渠道获取完整离线包(含 install.sh + hermes-agent-main.zip + uv-binary + python-3.11-embed-amd64.zip)并解压至 Linux 用户主目录 ~ 下。

2、修改 install.sh 文件,在 git clone 步骤前插入 exit 0 命令,强制中断联网行为。

3、执行 chmod +x install.sh && ./install.sh 启动环境初始化流程。

4、脚本运行至提示“Cloning into 'hermes-agent'...”前会自动退出,此时手动解压 hermes-agent-main.zip 到 ~/.hermes/src/ 目录。

5、进入 ~/.hermes/src/ 目录,运行 uv venv --python=python3.11 && source .venv/bin/activate。

6、执行 pip install -e . --find-links ./wheels --no-index 安装所有 wheel 本地包(需提前将依赖 wheel 放入 ./wheels 子目录)。

二、基于 Docker 构建离线镜像

该方法适用于已具备 Docker 环境且允许导入镜像的离线节点,所有构建阶段均在有网机器完成,最终仅导出 tar 镜像文件供离线加载。

1、在联网机器上创建 Dockerfile,基础镜像选用 python:3.11-slim,并 COPY 官方源码、requirements.txt 和离线 wheel 包。

2、RUN pip install --find-links ./wheels --no-index -r requirements.txt 完成全部 Python 依赖安装。

3、RUN pip install -e . 将 Hermes Agent 以开发模式安装进镜像。

4、ADD entrypoint.sh /entrypoint.sh 并设置 CMD ["/entrypoint.sh"] 启动代理服务。

5、执行 docker build -t hermes-offline:latest . 构建镜像。

6、执行 docker save hermes-offline:latest > hermes-offline.tar 将镜像保存为归档文件。

7、将 hermes-offline.tar 复制至目标离线服务器,运行 docker load

8、执行 docker run -d --name hermes -p 8000:8000 -v ~/.hermes:/root/.hermes hermes-offline:latest 启动容器。

三、手动构建离线 wheel 依赖树

该方法适用于对环境控制要求极高、需审计每个依赖来源的场景,通过 pip download 在联网机器完整捕获 Hermes Agent 所需全部 wheel 文件及其传递依赖。

1、在联网机器新建临时目录,cd 进入后克隆官方仓库:git clone https://github.com/NousResearch/hermes-agent.git。

2、创建干净虚拟环境:python3.11 -m venv offline-env && source offline-env/bin/activate。

3、执行 pip download -r hermes-agent/requirements.txt --no-deps --platform manylinux2014_x86_64 --only-binary=:all: --python-version 311 --abi cp311 -d wheels/。

4、对每个未满足的依赖,递归执行 pip download --no-deps --platform ... -d wheels/ 直至 wheel 目录中包含全部 .whl 文件(不含 .tar.gz)。

Hermes Agent
Hermes Agent

将OpenClaw打造为具备种子工作空间规则、技能提升、反思记忆和主动维护的学习循环智能体。

下载

5、将整个 wheels/ 目录与 hermes-agent/ 源码一同复制至离线机器。

6、在离线机器上创建新 venv,激活后执行 pip install --find-links ./wheels --no-index -e ../hermes-agent。

7、验证安装:hermes --version 应输出版本号,且 ~/.hermes/ 目录结构完整生成。

四、SUSE 11 SP4 等老旧系统适配方案

针对 SUSE 11 SP4 等不支持现代 Python 版本或缺乏编译工具链的系统,需采用静态链接与预编译二进制替代标准安装流程。

1、在兼容目标系统的构建机(如相同内核版本的 Docker 容器)中安装 pyinstaller 与 uv。

2、使用 uv venv --python=3.11.9 和 pip install -e . 构建可运行环境。

3、执行 pyinstaller --onefile --add-data "~/.hermes;./.hermes" --hidden-import="uv" hermes/__main__.py 生成单体可执行文件。

4、将生成的 dist/hermes 文件及配套的 ~/.hermes/config.yaml、.env 等配置模板打包为离线部署包。

5、在 SUSE 11 SP4 目标机器上解压部署包,赋予 hermes 可执行权限:chmod +x hermes。

6、执行 LD_LIBRARY_PATH=./lib ./hermes --setup 启动初始配置向导(所有依赖库已静态打包进 lib/ 子目录)。

五、Windows 离线部署(PowerShell 兼容版)

该路径绕过 install.ps1 的联网检测机制,改用本地资源注入方式完成 Windows 环境下 Hermes Agent 的零外网安装。

1、在联网 Windows 机器上下载 install.ps1 脚本,并使用 Notepad++ 打开,搜索 "git clone" 行并注释掉整段 clone 逻辑。

2、下载 Python 3.11 Embeddable Zip、Node.js 18.x Windows Binary、Git for Windows 安装包(.exe)、ripgrep-14.1.0-x86_64-pc-windows-msvc.zip。

3、将上述全部二进制压缩包与 hermes-agent-main.zip 一同放入 C:\hermes-offline\ 目录。

4、编写 setup-local.ps1 脚本,依次解压 Python、Node、Git 到 C:\hermes-env\,并将 PATH 注入注册表 CurrentUser\Environment。

5、解压 hermes-agent-main.zip 到 C:\hermes-env\src\,执行 C:\hermes-env\python\python.exe -m pip install -e C:\hermes-env\src。

6、运行 setup-local.ps1 完成本地环境搭建。

7、执行 hermes gateway setup 时,手动指定飞书 App ID/Secret 并跳过自动依赖安装步骤,因 lark-oapi 已预装于 C:\hermes-env\src\wheels\ 中。

8、关键验证点:hermes --help 必须正常输出命令列表,且 hermes gateway status 返回 active 状态。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

hermes agent

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Hermes Agent完整设置指南教程
Hermes Agent完整设置指南教程

此专题为您提供 HermesAgent最新、最全面的设置指南。内容涵盖从一键安装、模型配置(支持阿里云百炼等)到微信、钉钉等全平台接入的完整流程。无论您是新手还是进阶用户,都能在这里找到清晰的步骤说明与常见问题解答,助您快速部署并掌握这款能自我进化的AI代理,轻松开启智能化工作流。

2026.04.13

612

11

Hermes Agent完整部署教程
Hermes Agent完整部署教程

本专题聚焦开源AI智能体Hermes Agent,提供从入门到精通的完整部署教程。作为会“自我进化”的AI助手,它支持本地及云端私有化部署,具备持久记忆与技能自动沉淀能力。无论你是开发者还是效率追求者,这里都将助你快速搭建专属的“数字伙伴”,实现AI自主执行复杂任务,让工作效率倍增。

2026.04.13

554

20

HermesAgent下载安装完整教程
HermesAgent下载安装完整教程

本专区为您提供 HermesAgent最全面的安装与部署指南。作为由NousResearch推出的“可成长”AI智能体,Hermes支持Linux、macOS及WSL2环境。我们汇集了从官方推荐的一键脚本安装、手动源码部署,到Docker及云服务器(如腾讯云Lighthouse)搭建的保姆级教程。无论您是新手还是开发者,都能在此找到详细的配置步骤,助您快速拥有这位具备持久记忆与自我进化能力的AI助手。

2026.04.13

457

21

Hermes Agent使用指南汇总
Hermes Agent使用指南汇总

本专题将带你从零开始,全面掌握Hermes Agent的安装部署、核心配置、技能扩展与生态整合,无论你是想打造专属私人助手,还是探索AI自动化变现路径,这里都有最实用的实战指南。

2026.05.06

629

34

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Hermes Agent中文文档
Hermes Agent中文文档

共0课时 | 0人学习