Hermes Agent 安装与配置:5 分钟上手指南

系列第2篇 | 上一篇讲了 Hermes Agent 是什么,这篇直接动手装。


环境要求

先确认你的机器满足条件:

项目 要求
操作系统 Linux / macOS / Windows(需 WSL2)
Python 3.9+
内存 建议 8GB+
必备工具 curlgitbash

⚠️ Windows 用户注意:Hermes 不支持原生 Windows 环境,必须先装 WSL2,再在里面操作。


第一步:一键安装

打开终端,粘贴这一行命令:

# 国内用户推荐(镜像加速,不卡 GitHub)
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

脚本会自动完成:检测并安装 uv、Python、Node.js、ripgrepffmpeg,创建虚拟环境,拉取代码,安装依赖。全程无需手动干预,大约 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 变成你的微信助手。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

相关阅读更多精彩内容

友情链接更多精彩内容