系列第2篇 | 上一篇讲了 Hermes Agent 是什么,这篇直接动手装。
环境要求
先确认你的机器满足条件:
| 项目 | 要求 |
|---|---|
| 操作系统 | Linux / macOS / Windows(需 WSL2) |
| Python | 3.9+ |
| 内存 | 建议 8GB+ |
| 必备工具 |
curl、git、bash
|
⚠️ Windows 用户注意:Hermes 不支持原生 Windows 环境,必须先装 WSL2,再在里面操作。
第一步:一键安装
打开终端,粘贴这一行命令:
# 国内用户推荐(镜像加速,不卡 GitHub)
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash
脚本会自动完成:检测并安装 uv、Python、Node.js、ripgrep、ffmpeg,创建虚拟环境,拉取代码,安装依赖。全程无需手动干预,大约 2 分钟搞定。
装完后,敲 hermes 验证是否成功。
第二步:配置模型
Hermes 本身不带模型,需要你接入一个 AI 服务。支持 OpenAI、DeepSeek、Qwen、智谱 GLM、Kimi、MiniMax 等主流选项。
以 DeepSeek 为例(性价比最高):
# 填入你的 API Key
hermes config set DEEPSEEK_API_KEY sk-xxxxxxxxxxxxxxxx
# 设置默认模型
hermes config set model.default deepseek-chat
# 设置服务商
hermes config set model.provider deepseek
# 设置接口地址
hermes config set model.base_url https://api.deepseek.com/v1
没有 API Key?去platform.deepseek.com注册,新用户有免费额度。
第三步:启动 & 验证
hermes
启动后,命令行会出现交互界面。试着输入:
帮我查一下今天北京的天气
能正常回复,说明模型配置成功。
常见问题速查
Q:安装卡住不动?
A:大概率是网络问题。换国内镜像命令重试。
Q:提示 externally-managed-environment?
提前跑这条命令规避:
sudo apt update && sudo apt install -y python3-qrcode python3-pil
Q:Windows 下 WSL2 怎么装?
管理员身份打开 PowerShell,执行:
wsl --install
重启后进入 Ubuntu,再按上面步骤操作。
小结
整个流程三步走:装 → 配模型 → 跑起来。最快 5 分钟,最慢也就是等网速。
下一篇:《Hermes Agent 接入微信:让 AI 住进你的聊天框》——把 Hermes 变成你的微信助手。