一、Hermes Agent 是什么?
Hermes Agent 是由 Nous Research 开发的开源 AI Agent 框架。一句话理解:它是一个「会自动学习、自我改进的 AI 助手」,能帮你查资料、写代码、管文件、发消息,而且越用越懂你。
它有几个特点特别值得新手知道:
开源免费:MIT 许可证,代码全部公开
技能自进化:解决过的问题会沉淀成可复用的"技能",下次自动调用
跨会话记忆:关掉再开,它还记着你
不绑定厂商:支持 20+ 模型提供商、400+ 模型,能自由切换
二、安装前准备
在 Linux 上安装,你只需要确认两样东西:
# 1. 检查 Python 版本(需要 3.11+)
python3 --version
# 2. 检查 git
git --version如果 Python 版本低于 3.11,需要先升级。git 没有的话 sudo apt install git 装一下。
三、安装 Hermes Agent
官方提供了一键安装脚本,直接执行:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash这个脚本会自动做这几件事:
拉取 Hermes 源码到
~/.hermes/hermes-agent创建 Python 虚拟环境并安装依赖(必要时会自动装
uv、Node.js 等)创建
hermes命令入口初始化数据目录
~/.hermes生成
config.yaml、.env、SOUL.md等配置文件(只在不存在的时才创建)
装完后,重新打开终端(或 source ~/.bashrc),输入 hermes --version 验证是否成功。
四、初次配置模型
装好之后,第一件事是告诉 Hermes 用哪个模型。有几种方式:
hermes model # 交互式选择模型和提供商
hermes setup # 运行完整配置向导
hermes setup --portal # 使用 Nous Portal 一键配置(推荐新手)推荐新手用 hermes setup --portal:通过 OAuth 登录 Nous 账号即可使用 400+ 模型,不用自己管理 API Key。
如果你想用自己的 API Key(比如 DeepSeek、OpenAI),配置在 ~/.hermes/.env 文件里,类似:
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxx小提示:API Key 都放在
~/.hermes/.env,这是敏感信息文件,别提交到 git 或分享给别人。
五、开始第一个对话
方式一:交互式对话(最常用)
hermes # 进入交互式聊天
hermes --tui # 用 TUI 图形化终端界面(v0.11+,更好看)进去之后直接打字提问就行。常用快捷键:
方式二:单次问答(脚本/一次性任务用)
hermes chat -q "查看系统资源占用情况"适合写脚本或偶尔问一句的场景。
方式三:Hermes Desktop 桌面应用(v0.16+)
如果不想碰终端,可以下载 Hermes Desktop 桌面版。底层和 CLI 完全共享同一套数据——白天在桌面聊天,晚上在终端跑定时任务,用的是同一套配置。
六、了解你的 Hermes 家目录
安装后,你的所有 Hermes 数据都在 ~/.hermes/ 下:
~/.hermes/
├── config.yaml # 主配置(模型、终端、压缩等)
├── .env # API 密钥(敏感)
├── auth.json # OAuth 凭证
├── SOUL.md # Agent 的人格文件
├── memories/ # 持久记忆(MEMORY.md、USER.md)
├── skills/ # 技能库
├── cron/ # 定时任务
├── sessions/ # 会话记录
└── logs/ # 日志理解这个结构很重要——后面所有配置、技能、记忆都是围绕这个目录展开的。
七、常用配置命令
hermes config # 查看当前配置
hermes config edit # 用编辑器打开 config.yaml
hermes config set section.key value # 直接设置某项配置
hermes doctor # 检查环境健康状态
hermes update # 更新到最新版本会话内也可以用斜杠命令调配置:
八、更新与卸载
hermes update # 更新升级前建议备份
~/.hermes/auth.json和~/.hermes/config.yaml。
卸载(彻底清理):
hermes uninstall
rm -rf ~/.hermes # 如需连数据一起删小结
到这一步,你已经完成了 Hermes Agent 的安装、配置和第一次对话。
评论区