推荐使用官方一键安装脚本：1、启用EPEL并安装git/curl/python3-pip等基础工具；2、执行curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash；3、运行hermes setup完成交互配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您计划在 CentOS 系统上部署 Hermes Agent，但遇到依赖冲突、网络拉取失败或权限配置异常等问题，则可能是由于系统默认 Python 版本过低、缺少 Rust 工具链或 SELinux 限制所致。以下是针对 CentOS 环境的多种可行部署步骤：
一、使用官方一键安装脚本部署
该方法适用于网络通畅、具备 root 权限且希望快速验证服务可用性的 CentOS 7.9+ 用户，脚本自动处理 Python 环境隔离、依赖安装与 systemd 服务注册。
1、确保系统已启用 EPEL 仓库：yum install -y epel-release
2、安装基础工具：yum install -y git curl wget python3-pip python3-devel gcc make
3、下载并执行官方安装脚本：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
4、等待脚本输出 Installation completed successfully 后，执行 hermes --version 验证二进制是否就绪
5、首次运行 hermes setup 进入交互式配置，选择 Quick setup 并填入模型提供商 API Key
二、基于源码编译部署（适配 CentOS 8/9）
该方法适用于需启用本地 Ollama 模型、定制 Rust 沙箱行为或审计全部构建产物的安全场景，要求系统预装 Rust 1.91+ 与 Python 3.12+。
1、升级系统并安装开发工具组：dnf groupinstall -y "Development Tools"
2、安装 Rust：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
3、加载 Rust 环境：source $HOME/.cargo/env
4、克隆项目：git clone https://github.com/hermes-org/agent.git && cd agent
5、检出稳定版本：git checkout v0.4.2
6、创建并激活 Python 虚拟环境：python3 -m venv venv && source venv/bin/activate
7、安装依赖：pip install -r requirements/base.txt pydantic==2.6.4
8、构建核心模块：make build-agent（需确保 Makefile 存在于 src/agent-sec-core）
9、将生成的可执行文件复制至系统路径：sudo cp target/release/hermes-agent /usr/local/bin/
三、Docker Compose 容器化部署（推荐用于生产隔离）
该方法规避主机环境差异，利用 Docker 官方镜像统一运行时，适用于已部署 Docker Engine 的 CentOS 7.9+ 或 CentOS Stream 9 系统。
1、安装 Docker CE：yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo && yum install -y docker-ce docker-ce-cli containerd.io
2、启动并启用 Docker 服务：systemctl enable --now docker
3、创建部署目录：mkdir -p /opt/hermes && cd /opt/hermes
4、创建 docker-compose.yml 文件，内容包含 service: hermes-agent 配置，指定 image: ghcr.io/nousresearch/hermes-agent:latest
5、设置环境变量：export MINIMAX_CN_API_KEY=your_actual_key（或直接写入 yml 文件的 environment 字段）
6、启动服务：docker-compose up -d
7、检查容器状态：docker ps -f name=hermes-agent --format "table {{.ID}}\t{{.Status}}\t{{.Ports}}"
四、离线环境部署（适配无外网 CentOS 内网服务器）
该方法专为断网或强管控内网环境设计，所有依赖与源码均提前打包，避免部署过程中触发任何外网请求。
1、在联网机器上下载百度网盘离线包：https://pan.baidu.com/s/1PMVQ4bANEhyie94IbRQ5GQ?pwd=9dbu
2、解压 hermes-agent-main.zip 至 /tmp/hermes-offline 目录
3、将 install.sh 脚本中所有 git clone 和 pip install 行注释掉，替换为 cp -r /tmp/hermes-offline/* ./
4、修改脚本末尾启动命令为 python3 main.py --config /etc/hermes/config.yaml
5、赋予脚本执行权限：chmod +x install.sh
6、在目标 CentOS 服务器上执行：./install.sh
7、手动创建配置目录并写入 .env：mkdir -p /etc/hermes && echo "MINIMAX_CN_API_KEY=your_key" > /etc/hermes/.env
