前言
本文介绍如何安装和配置 Hermes Agent。
环境要求
- Ubuntu / Debian 系统
- Node.js 22.x
- Git
- Python 3.12
- 网络可访问飞书（国内服务器可能需要代理）
第一步：准备系统环境
安装必要工具
新装的 Ubuntu / Debian 系统可能没有 curl，先更新软件源并安装必要工具：
sudo apt update
sudo apt install curl wget git -y
安装完成后验证 Git：
git --version
应该显示 git version 2.x.x。
第二步：安装 Node.js 22
添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
安装 Node.js
sudo apt install -y nodejs
验证 Node 版本
node -v
应该显示 v22.x。
第三步：安装 Python 3.12
方法一：通过 Deadsnakes PPA 安装（推荐）
适合 Ubuntu 20.04、22.04 及更早版本。
添加 deadsnakes PPA 源。
sudo add-apt-repository ppa:deadsnakes/ppa
更新软件包列表。
sudo apt update
安装 Python 3.12 及常用组件。
sudo apt install python3.12 python3.12-venv python3.12-dev
安装完成后验证：
python3.12 --version
应该显示 Python 3.12.x。
方法二：使用 APT 直接安装（仅限 Ubuntu 24.04+）
sudo apt update
sudo apt install python3.12 python3.12-venv python3.12-dev
方法三：从源码编译安装
⚠️ 注意：编译 Python 源码可能需要 10-30 分钟，低配服务器可能更久。如果 SSH 连接不稳定或可能中断，建议先执行
screen -S python-build创建会话，中途断开也不会导致编译失败。
安装编译依赖。
sudo apt update
sudo apt install build-essential libssl-dev zlib1g-dev libffi-dev libreadline-dev libsqlite3-dev -y
下载并编译源码。
wget https://www.python.org/ftp/python/3.12.0/Python-3.12.0.tgz
tar -xvf Python-3.12.0.tgz
cd Python-3.12.0
./configure --enable-optimizations
make -j $(nproc)
⏳ 编译过程较慢，请耐心等待。
sudo make altinstall
如果使用了 screen，中途可以按
Ctrl+A D切出会话，回来后执行screen -r python-build恢复。
验证 Python 版本
python3.12 --version
第四步：安装 Hermes Agent
使用官方国内镜像一键安装（推荐）
curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
这个脚本会自动完成所有安装步骤。
第五步：安装后的配置步骤
刷新环境变量
安装完成后，为了让 hermes 命令立即生效。
source ~/.bashrc
验证安装
hermes --version
如果能看到版本号（例如 hermes v0.8.0），就说明核心程序安装成功了。
运行配置向导
这是最关键的一步，用来连接 AI 模型。你需要一个 API Key（例如从阿里云百炼、OpenRouter 等平台获取）。
hermes setup
根据向导提示，选择你的模型提供商（如阿里云百炼、OpenRouter 等），输入 API Key，完成配置。
常见问题
Q: 安装脚本报错 "command not found"？
A: 可能是因为环境变量未加载。运行 source ~/.bashrc 后重试。
Q: hermes setup 一直卡住不动？
A: 检查网络是否稳定，确保能访问你配置的模型服务商 API。
Q: 如何卸载 Hermes Agent？
A: 参考另一篇文章《Hermes Agent 完整卸载指南》。
评论 (0)
暂无评论