AI|服务器安装Hermes Agent 教程/新增更新教程【新版】

更新时间:2026-04-23 21:12:05

访问次数:188

详细介绍

优化了之前多余的动作和操作步骤,而且依然没说明怎么配置api/本地大模型、飞书等教程(需要的自己去https://hermes.xaapi.ai/guide/configuration 查看 )

系统:Ubuntu 22.04.4CPU:4核心内存:3.8GB硬盘内存:39.1GB


# ==============================================
# 【步骤1】创建 Hermes 专用安装目录
# 作用:给 Hermes 存放文件的目录
# ==============================================
mkdir -p /root/.hermes

# ==============================================
# 【步骤2】进入目录
# 作用:后续下载、解压都在这个目录执行
# ==============================================
cd /root/.hermes

# ==============================================
# 【步骤3】下载 Hermes 官方源码 ZIP(最稳、不断链)
# 作用:下载主分支源码,重命名为 hermes-agent.zip
# ==============================================
wget https://github.com/NousResearch/hermes-agent/archive/refs/heads/main.zip -O hermes-agent.zip

# ==============================================
# 如果【步骤3】下载失败,可以考虑使用这个方法:
# 在你的电脑下载完整的压缩包。然后上传到/root/.hermes文件夹
# ==============================================
https://github.com/NousResearch/hermes-agent/archive/refs/heads/main.zip


# ==============================================
# 【步骤3】失败的相关流程
# 进入目录
cd ~/.hermes

# 解压文件
unzip main.zip

# 重命名文件夹(方便后续操作)
mv hermes-agent-main hermes-agent

# 进入项目目录
cd hermes-agent

# 确认文件是否完整(必须看到 pyproject.toml)
ls -la

# ==============================================


# ==============================================
# 【步骤4】解压 ZIP 压缩包
# 作用:把压缩包里的源码解压出来
# ==============================================
unzip hermes-agent.zip

# ==============================================
# 【步骤5】重命名目录
# 作用:把 hermes-agent-main 改为标准名称 hermes-agent
# ==============================================
mv hermes-agent-main hermes-agent

# ==============================================
# 【步骤6】进入源码目录(必须进,否则安装失败)
# ==============================================
cd hermes-agent

# ==============================================
# 【步骤7】安装 uv 依赖管理器(修复 Git 报错,不使用官方脚本)
# 作用:自动安装依赖,不碰 Git,不冲突宝塔
# ==============================================
curl -LsSf https://astral.sh/uv/install.sh | sh

# ==============================================
# 【步骤8】让环境变量立即生效(必须执行)
# 作用:让 uv 命令可以直接使用
# ==============================================
source /root/.bashrc

# ==============================================
# 【步骤9】创建虚拟环境
# 作用:隔离环境,不影响宝塔、网站、系统
# ==============================================
uv venv .venv

# ==============================================
# 【步骤10】激活虚拟环境
# ==============================================
source .venv/bin/activate

# ==============================================
# 【步骤11】安装 Hermes 本体
# 作用:本地安装,不依赖 Git,不报错
# ==============================================
uv pip install -e .

# ==============================================
# 【步骤12】创建全局命令(任意目录可使用 hermes)
# ==============================================
ln -sf /root/.hermes/hermes-agent/.venv/bin/hermes /usr/local/bin/hermes
# 验证是否安装成功
hermes --version

# 初始化配置
hermes setup

# 启动对话
hermes chat



更新前先备份

cp -r ~/.hermes ~/.hermes-backup
hermes update --backup


更新教程:

下载带完整脚本的源码包(这次用 tar.gz 格式,比 zip 更稳定)

wget https://github.com/NousResearch/hermes-agent/archive/refs/heads/main.tar.gz -O hermes-agent.tar.gz
解压并复制到你教程里指定的目录
# 解压tar包
tar -xzf hermes-agent.tar.gz

# 按教程的方式,复制到~/.hermes目录(覆盖旧版本,不碰配置)
mkdir -p ~/.hermes
cp -r hermes-agent-main ~/.hermes/hermes-agent
执行正确的安装脚本
# 进入目录执行安装脚本
cd ~/.hermes/hermes-agent
bash scripts/install.sh
验证安装结果
# 重载环境变量
source ~/.bashrc

# 查看版本信息
hermes --version

# 启动Hermes检查是否正常
hermes


1.如果下载失败,用本地更新方法:

2.把下载好的压缩包,上传到你的服务器

  • 打开宝塔面板 → 左侧「文件」→ 进入 /root 目录

  • 点击「上传」,把你电脑上的 hermes-agent.zip 上传到服务器的 /root 目录里

  • 上传完成后,在宝塔里确认文件大小和你电脑上的一致,说明上传成功。

3.解压并按你原来的方式覆盖安装

# 解压上传好的压缩包【如果压缩包名称不一样,就改为一样在执行命令】
unzip hermes-agent.zip

# 覆盖安装到你原来的目录
cp -r hermes-agent-main/* ~/.hermes/hermes-agent/

# 执行安装脚本
cd ~/.hermes/hermes-agent
bash scripts/install.sh

# 重载环境变量
source ~/.bashrc

# 查看版本信息
hermes --version


猜你喜欢

网友评论