简介

Hermes Agent 是一个强大的 AI 助手框架，可以通过 Docker 快速部署。本文将介绍如何使用 Docker 容器化部署 Hermes Agent。

快速开始

基础部署命令

docker run -it --rm \
  -v /vol1/1000/docker/hermes:/opt/data \
  nousresearch/hermes-agent \
  setup

简化命令

docker run -it --rm nousresearch/hermes-agent setup

配置说明

数据卷挂载

  • -v /vol1/1000/docker/hermes:/opt/data: 将本地目录挂载到容器内，用于持久化数据

环境变量配置

部署完成后，需要配置以下服务的 API 密钥：

Browser Use

Fal.ai

Firecrawl

配置示例

创建 .env 文件：

BROWSER_USE_API_KEY=YOUR_BROWSER_USE_API_KEY
FAL_API_KEY=YOUR_FAL_API_KEY
FIRECRAWL_API_KEY=YOUR_FIRECRAWL_API_KEY

运行时加载环境变量：

docker run -it --rm \
  --env-file .env \
  -v /vol1/1000/docker/hermes:/opt/data \
  nousresearch/hermes-agent \
  setup

常用命令

# 启动 Hermes
docker start hermes-agent

# 查看日志
docker logs -f hermes-agent

# 进入容器
docker exec -it hermes-agent bash

# 停止容器
docker stop hermes-agent

注意事项

  1. 数据持久化: 确保挂载卷路径正确，避免数据丢失
  2. API 密钥安全: 不要将密钥提交到代码仓库
  3. 网络配置: 如需访问外部服务，确保容器网络配置正确
  4. 资源限制: 根据需要设置 CPU 和内存限制

故障排查

容器无法启动

# 检查容器状态
docker ps -a

# 查看详细日志
docker logs hermes-agent

API 连接失败

  1. 检查 API 密钥是否正确
  2. 确认网络连接正常
  3. 验证 API 服务是否可用

参考链接

如有问题，欢迎在评论区留言交流。