需通过docker完成容器化部署：先安装docker engine与docker compose，再克隆仓库、修改配置、构建镜像（docker build -t hermes-agent:edge），接着可用docker compose up -d编排启动，或用docker run直接运行单体容器，最后在~/.hermes/config.yaml中配置docker后端以支持沙箱化工具调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在本地或边缘设备上运行Hermes Agent，但尚未将其打包为独立、可移植的运行单元，则需通过Docker完成容器化部署。以下是实现该目标的具体方法：
一、准备Docker运行环境
确保目标系统已安装兼容版本的Docker Engine与Docker Compose，这是容器化部署的基础依赖。缺少任一组件将导致镜像构建或容器启动失败。
1、执行命令检查Docker是否已安装并正常运行：docker --version
2、验证Docker Compose版本是否满足要求（v2.0+）：docker compose version
3、若未安装，从Docker官方渠道下载对应操作系统的安装包，并完成系统级服务启用与用户组权限配置。
二、构建Hermes Agent自定义镜像
使用项目内置Dockerfile生成轻量、适配边缘场景的镜像，该过程将封装代码、依赖及运行时配置，确保环境一致性。
1、克隆Hermes Agent源码仓库：git clone https://gitcode.com/GitHub_Trending/he/hermes-agent
2、进入项目根目录：cd hermes-agent
3、修改environments/default.yaml中的agent参数，例如设置上下文长度与工具缓存开关：
4、执行镜像构建命令：docker build -t hermes-agent:edge -f environments/Dockerfile .
三、基于Docker Compose启动服务栈
Docker Compose可声明式编排多容器协同运行，适用于需集成日志、监控或配套工具的完整开发环境。
1、确认项目根目录存在docker-compose.yml文件（若无，参考examples/docker-compose.edge.yml模板创建）
2、在配置中指定镜像名称、挂载路径与端口映射，例如将宿主机8080端口绑定至容器内8080端口
3、执行一键启动：docker compose up -d
4、查看容器运行状态：docker compose ps
四、运行单体容器进行快速验证
适用于轻量测试或资源受限设备，跳过编排层直接运行Agent实例，便于快速确认基础功能可用性。
1、创建本地配置目录并复制默认配置：mkdir -p ./config && cp environments/default.yaml ./config/
2、执行容器运行命令：docker run -d --name hermes-edge-agent -v ./config:/app/config -p 8080:8080 hermes-agent:edge --mode edge --log-level info
3、通过curl或浏览器访问http://localhost:8080/health验证服务响应
五、配置Docker后端终端支持
Hermes Agent需明确声明使用Docker作为命令执行沙箱，此配置决定其内部任务如何被容器化隔离运行。
1、编辑用户级配置文件：~/.hermes/config.yaml
2、设置terminal backend为docker，并指定基础镜像与工作目录：
3、保存后重启Agent进程，后续所有工具调用将自动在Docker容器中执行
