一、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

这个脚本会自动做这几件事:

  1. 拉取 Hermes 源码到 ~/.hermes/hermes-agent

  2. 创建 Python 虚拟环境并安装依赖(必要时会自动装 uv、Node.js 等)

  3. 创建 hermes 命令入口

  4. 初始化数据目录 ~/.hermes

  5. 生成 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+,更好看)

进去之后直接打字提问就行。常用快捷键:

快捷键

功能

Ctrl + C

中断当前操作

Ctrl + D

退出会话

Ctrl + Z

挂起到后台,用 fg 恢复

Alt + Enter

换行输入

方式二:单次问答(脚本/一次性任务用)

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                        # 更新到最新版本

会话内也可以用斜杠命令调配置:

命令

功能

/config

查看当前配置

/model [name]

查看/切换当前模型

/personality [name]

切换人格(helpful、concise、technical 等 14 种)

/reasoning [level]

调整推理级别

/yolo

减少工具执行确认(仅建议在可信环境用)

八、更新与卸载

hermes update      # 更新

升级前建议备份 ~/.hermes/auth.json 和 ~/.hermes/config.yaml。

卸载(彻底清理):

hermes uninstall
rm -rf ~/.hermes    # 如需连数据一起删

小结

到这一步,你已经完成了 Hermes Agent 的安装、配置和第一次对话。