Hermes Agent 是由 Nous Research(知名开源AI实验室,开发过Hermes系列大模型)推出的 GitHub 顶级开源自主AI智能体(GitHub: NousResearch/hermes-agent)。
🌟 核心定位:越用越聪明的永久AI助手
口号:An Agent That Grows With You(与你共同成长的智能体)
• 不是聊天机器人:部署在你的服务器/VPS,永久在线
• 自主进化:会自动学习、记忆、构建专属技能
• 跨平台:通过Telegram、Discord、飞书、企业微信等控制
🚀 核心特性(2026最新)
- 持久记忆与自我进化
◦ 四层记忆系统(活跃上下文、情景记忆、技能库、长期记忆)
◦ 自动总结经验,生成可复用的 Skills(技能)
- 强大工具链
◦ 内置40+工具:文件读写、代码执行、浏览器操控、SSH、API调用
◦ 6种终端后端(本地/Docker/SSH/Modal等)
- 多平台消息网关
◦ 支持:Telegram, Discord, Slack, WhatsApp, 飞书(Feishu), 企业微信(WeCom)
◦ 一处部署,处处可用
- 安全沙箱
◦ 代码与工具执行在隔离环境,防止恶意操作
◦ 关键操作需人工审批
⚙️ 快速安装(Linux/macOS/WSL)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup # 配置模型
hermes # 启动!
📌 与其他Agent的区别
• OpenAI Assistants: 云端托管,数据不可控
• AutoGPT: 早期项目,架构老旧,稳定性差
• Hermes Agent: 本地部署+自我进化+生产级安全+多平台
源码启动指南
从源码下载后到纯源码启动的步骤
1. 进入项目目录
bash
cd /Users/xx/code/github/hermes-agent
2. 创建虚拟环境
bash
python3.11 -m venv venv
3. 激活虚拟环境
bash
source venv/bin/activate
4. 安装基础工具
bash
python -m pip install -U pip setuptools wheel
5. 安装源码运行依赖
bash
python -m pip install -r requirements.txt
这里安装的是第三方依赖,不是把当前 Hermes 源码安装成包。
纯源码运行时,不需要执行
pip install -e .,也不依赖hermes命令。
6. 创建 Hermes 用户配置目录
bash
mkdir -p ~/.hermes
7. 配置 API Key
编辑 ~/.hermes/.env,例如:
bash
cat > ~/.hermes/.env <<'EOF'
OPENAI_API_KEY=sk-你的key
EOF
8. 配置模型和 endpoint
编辑 ~/.hermes/config.yaml:
bash
cat > ~/.hermes/config.yaml <<'EOF'
model:
default: "gpt-5.4"
provider: "custom"
base_url: "https://api.openai.com/v1"
EOF
启动方式
9. 用源码入口启动
bash
cd /Users/xx/code/github/hermes-agent
source venv/bin/activate
python -m hermes_cli.main
10. 快速测试
bash
python -m hermes_cli.main chat -q "hello"
如果你还需要"编译"
如果你的意思是先验证源码能被打包构建,再从源码运行,可以额外执行:
bash
python -m pip install build
python -m build
这一步只负责生成构建产物(如 dist/*.whl、dist/*.tar.gz),
和"是否通过源码入口运行"是两件事。
以后再次启动
后续不需要重复建环境,只要:
bash
cd /Users/xx/code/github/hermes-agent
source venv/bin/activate
python -m hermes_cli.main
配置文件位置
- API Key:
~/.hermes/.env - 模型配置:
~/.hermes/config.yaml
常见检查项
如果启动失败,优先检查:
venv是否已激活- 是否执行过
python -m pip install -r requirements.txt ~/.hermes/.env中的 API key 是否正确~/.hermes/config.yaml是否包含以下配置:
yaml
model:
default: "gpt-5.4"
provider: "custom"
base_url: "https://api.openai.com/v1"
核心区别
- 纯源码运行 :
python -m hermes_cli.main - 安装后运行 :
hermes
界面启动效果:





Hermes 内置持久记忆分析
我刚查到你这边当前环境里的路径是:
- HERMES_HOME: /Users/xx/.hermes
- 记忆目录: /Users/xx/.hermes/memories
默认存成两个文件:
- /Users/xx/.hermes/memories/USER.md
用来存"关于你的信息",比如语言偏好、回答风格、习惯 - /Users/xx/.hermes/memories/MEMORY.md
用来存"我的工作笔记",比如环境事实、项目约定、工具坑点
你刚才让我记住"默认使用中文输出",这类通常会写进:
补充两点:
-
它是按 profile 隔离的
也就是代码里不是硬编码 ~/.hermes,而是用 HERMES_HOME/memories。
如果切换 Hermes profile,记忆目录也会跟着变。
-
本轮新写入会立刻落盘
但系统提示里注入的"记忆快照"通常在下次会话开始时刷新,所以"持久化"是实时的,"完整重新加载生效"是下一次会话最稳定。