OpenCloudOS9(RHEL9系 dnf)安装 Hermes-Agent完整教程

OpenCloudOS9基于RHEL9,官方一键bash脚本无法直接适配dnf源,优先采用【源码手动部署】(最稳),分4大步,全程root/普通用户均可(推荐普通用户)。

Hermes硬性依赖:Python3.11、Node22、ffmpeg、ripgrep、git、uv

一、系统预装系统依赖(dnf)

bash 复制代码
#1 更新系统+安装EPEL源(必备)
sudo dnf update -y
sudo dnf install epel-release -y

#2 安装系统底层依赖
sudo dnf install -y git ffmpeg ffmpeg-devel ripgrep gcc openssl-devel \
bzip2-devel libffi-devel make cmake wget unzip

校验基础软件

bash 复制代码
ffmpeg -v; rg --version; git --version

二、安装Node.js 22(必须v22,系统自带node版本太低)

OpenCloudOS9官方源node最高18,手动安装node22:

bash 复制代码
#导入node22官方源
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo dnf install nodejs -y
node -v #输出v22.x.x即正常

三、安装uv包管理器(Hermes专用Python环境管理)

bash 复制代码
#国内加速安装uv
curl -LsSf https://astral.sh/uv/install.sh | sh
#写入环境变量
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
uv --version

四、源码编译安装Hermes-Agent(核心步骤)

bash 复制代码
#1 克隆源码(带子模块,必加--recurse-submodules)
git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git ~/hermes-agent
cd ~/hermes-agent

#2 uv自动拉取Python3.11、创建独立虚拟环境
uv python install 3.11
uv venv --python 3.11 .venv
source .venv/bin/activate

#3 全量安装Hermes所有依赖
uv pip install -e ".[all]"

#4 全局生成hermes软链接(任意目录可执行hermes命令)
mkdir -p ~/.local/bin
ln -sf $(pwd)/.venv/bin/hermes ~/.local/bin/hermes
source ~/.bashrc

五、初始化配置&启动

bash 复制代码
#1 环境自检(排查缺项)
hermes doctor
#2 配置大模型密钥(Kimi/Deepseek/Ollama/OpenAI任选其一)
hermes setup
#3 启动对话
hermes chat

六、Docker极简安装(不想编译选这个,OpenCloudOS9通用)

bash 复制代码
#安装docker
sudo dnf install docker-ce docker-ce-cli containerd.io --nobest -y
sudo systemctl enable --now docker
sudo usermod -aG docker $USER;newgrp docker

#拉取镜像启动
docker pull nousresearch/hermes-agent:latest
mkdir -p ~/.hermes/config
docker run -d --name hermes-agent -v ~/.hermes/config:/root/.hermes nousresearch/hermes-agent:latest
#进入容器配置
docker exec -it hermes-agent hermes setup

七、常见报错处理

  1. hermes doctor提示缺少ffmpeg/rg:重新执行第一步dnf安装命令
  2. node版本不足 :重装node22,禁用系统默认node模块:sudo dnf module disable nodejs -y
  3. git克隆超时:换国内镜像仓库克隆
bash 复制代码
git clone https://gitee.com/mirrors/hermes-agent.git ~/hermes-agent
cd ~/hermes-agent && git submodule update --init --recursive
  1. PATH不生效 :source ~/.bashrc或重启终端
相关推荐
数字新视界6 分钟前
全国产化动环监控平台在机房智能化管理中的应用探索
大数据·人工智能·数据中心·机房管理·模块化机房
laoyeye83129 分钟前
手写 vLLM 分页 KV Cache(三):引用计数、写时复制(CoW)与前缀缓存
人工智能·github
小码哥06839 分钟前
AI+能源管理系统如何用于工厂?云捷EMS能源管理系统功能与界面详解
人工智能·能源·能源管理系统·能耗监测·能源管理系统源码·企业能源管理系统·ai+能源管理系统
墨林陌39 分钟前
AI 热点日报(2026-11-19):Anthropic 全球史上最大 IPO 上市,谷歌发布 Gemini 4 Neon
人工智能
阿里云大数据AI技术1 小时前
把可观测做成基础设施:阿里云 Elasticsearch 监控链路的一次彻底重构
人工智能
TDengine (老段)1 小时前
TDengine IDMP 预测、异常检测与数据插补
大数据·数据库·人工智能·时序数据库·tdengine·涛思数据·idmp
甲维斯2 小时前
GPT6.2“买家秀”来了,吼吼呵呵!
人工智能
艾莉丝努力练剑2 小时前
【AI大模型接入SDK】C++的SessionManager 线程安全
java·开发语言·前端·c++·人工智能·学习·安全
螺丝钉tina4 小时前
[Playwright] [20][AI] 失败分析:让AI大模型帮你debug
人工智能
MSTcheng.4 小时前
【AI应用实战】用 FastAPI + SSE 做一个自己的 AI 聊天网页:流式输出、多轮对话与完整源码
人工智能·python·大模型·fastapi·sse·ai聊天助手