Hermes Agent: Hermes Agent 安装
最后更新：2026-08-31
安装 Hermes Agent 就像给电脑装一个会学习的助手——装一次，它就一直在那里等着帮你。
💡 提示：推荐使用 pip 安装，最简单快速。Docker 方式适合服务器部署。桌面版适合非技术用户。
📋 前置知识：第1课 Hermes Agent 简介与核心特性
1. 你将学到
| 编号 | 内容 |
|---|---|
| ❶ | 系统要求与环境检查 |
| ❷ | pip 安装（推荐） |
| ❸ | 源码安装 |
| ❹ | Docker 安装 |
| ❺ | 安装验证与常见问题 |
2. 故事
(1) 痛点：装不上环境
Bob 想试试 Hermes Agent，但 Python 版本不对、依赖冲突、权限问题……折腾了一下午还没跑起来。
(2) 解法：三步安装
Alice 只用了三步就装好了：
BASH
# 1. 检查环境
python --version # Python 3.10+
# 2. 一键安装
pip install hermes-agent
# 3. 初始化
hermes init
# 完成！开始对话
hermes chat
Bob 照做，5 分钟就跑起来了。
3. 系统要求
(1) 最低要求
| 组件 | 最低 | 推荐 |
|---|---|---|
| Python | 3.10 | 3.11+ |
| RAM | 4 GB | 8 GB+ |
| 磁盘 | 2 GB | 10 GB+ |
| OS | Linux/macOS/Windows | Linux/macOS |
(2) 环境检查脚本
BASH
# 一键检查环境
curl -sSL https://hermes.dev/check-env.sh | bash
PYTHON
# 或者用 Python 检查
import sys
import platform
print(f"Python: {sys.version}")
print(f"Platform: {platform.system()} {platform.release()}")
print(f"Python >= 3.10: {sys.version_info >= (3, 10)}")
💻 输出：
TEXT
📖 仅展示
Python: 3.11.5
Platform: Linux 6.1.0
Python >= 3.10: True
4. 安装方式
(1) pip 安装（推荐）
BASH
# 基础安装
pip install hermes-agent
# 带全部平台支持
pip install hermes-agent[all]
# 只装特定平台
pip install hermes-agent[telegram,discord]
# 带 GPU 加速（本地模型推理）
pip install hermes-agent[gpu]
安装后的命令行工具：
BASH
hermes --version # 查看版本
hermes init # 初始化配置
hermes chat # 开始对话
hermes serve # 启动 API 服务
hermes platform list # 查看可用平台
(2) 源码安装
BASH
# 克隆仓库
git clone https://github.com/nous-research/hermes-agent.git
cd hermes-agent
# 创建虚拟环境
python -m venv venv
source venv/bin/activate # Linux/macOS
# venv\Scripts\activate # Windows
# 安装依赖
pip install -e ".[dev]"
# 验证
hermes --version
(3) Docker 安装
BASH
# 拉取官方镜像
docker pull nousresearch/hermes-agent:latest
# 运行（带交互式对话）
docker run -it \
-v ~/.hermes:/root/.hermes \
-e HERMES_MODEL=gpt-4o \
nousresearch/hermes-agent:latest \
hermes chat
# 使用 docker-compose
curl -O https://hermes.dev/docker-compose.yml
docker-compose up -d
YAML
# docker-compose.yml
version: "3.8"
services:
hermes:
image: nousresearch/hermes-agent:latest
volumes:
- ./hermes-data:/root/.hermes
environment:
- HERMES_MODEL=gpt-4o
- OPENAI_API_KEY=${OPENAI_API_KEY}
ports:
- "8080:8080"
restart: unless-stopped
5. 初始化配置
BASH
# 交互式初始化
hermes init
# 初始化过程会询问：
? 选择默认模型: gpt-4o
? 输入 OpenAI API Key: sk-...
? 选择存储位置: ~/.hermes
? 是否启用遥测: No
? 创建示例技能? Yes
初始化后生成的目录结构：
~/.hermes/
├── config.yaml # 主配置文件
├── models.yaml # 模型配置
├── memory/ # 记忆存储
│ ├── working/ # 工作记忆
│ ├── long_term/ # 长期记忆
│ └── user_models/ # 用户模型
├── skills/ # 技能存储
│ ├── built_in/ # 内置技能
│ └── custom/ # 自定义技能
├── tools/ # 自定义工具
├── plugins/ # 插件
└── logs/ # 日志
6. 安装验证
BASH
# 完整验证
hermes doctor
# 输出示例：
# ✅ Python 3.11.5
# ✅ Hermes Agent v1.0.0
# ✅ 配置文件存在
# ✅ 记忆系统正常
# ✅ 技能引擎正常
# ✅ 工具注册: 72 个
# ✅ 模型连接: gpt-4o (OK)
# ✅ 存储空间: 8.2 GB 可用
试一试：首次对话
BASH
hermes chat
> 你好，我是 Hermes！
> 我记得关于你的信息（目前还没有，但我会学习的！）
> 试试告诉我你的名字和偏好吧。
me: 我叫 Alice，我是前端开发者，喜欢 TypeScript 和 React
> 记住了！从现在起我会记住：
> - 你叫 Alice
> - 前端开发者
> - 偏好 TypeScript + React
> 需要我帮你做什么？
7. 常见安装问题
| 问题 | 原因 | 解决方案 |
|---|---|---|
pip install 失败 |
Python 版本过低 | 升级到 Python 3.10+ |
| 权限被拒 | 系统目录权限 | 使用 --user 或虚拟环境 |
| 依赖冲突 | 其他包版本冲突 | 使用 venv 隔离环境 |
| Docker 无法启动 | Docker 未安装/未运行 | 安装 Docker Desktop |
| API Key 无效 | Key 过期或格式错 | 检查 config.yaml 中的 Key |
| 记忆初始化失败 | 目录权限问题 | chmod 755 ~/.hermes |
BASH
# 清理重装
pip uninstall hermes-agent -y
rm -rf ~/.hermes
pip install hermes-agent
hermes init
❓ 常见问题
Q Windows 上能安装吗？
A 可以。Hermes 支持 Windows 10/11，建议使用 WSL2 或 PowerShell 7+。部分功能（如 Shell 工具）在 WSL2 中体验更好。
Q 需要 GPU 吗？
A 不需要。GPU 仅在使用本地模型推理时需要（通过 Ollama/vLLM）。使用云端 API 不需要 GPU。
Q 能和其他 Python 项目共存吗？
A 建议使用虚拟环境（venv/conda），避免依赖冲突。Hermes 不会影响其他项目的依赖。
Q 如何更新到最新版？
A
pip install --upgrade hermes-agent。配置文件和记忆数据会保留，不会被覆盖。Q 安装后占多少空间？
A 基础安装约 200 MB，加上依赖约 500 MB。记忆和技能数据随使用增长，通常每月增加 10-50 MB。
Q 能在树莓派上运行吗？
A 树莓派 4 (4GB) 可以运行，但只能使用云端模型。本地模型推理需要更强的硬件。
📖 小节
- 三种安装方式：pip（推荐）、源码、Docker
- pip 一行命令即可安装：
pip install hermes-agent[all] hermes init交互式初始化，自动创建目录结构hermes doctor验证安装是否成功- 虚拟环境避免依赖冲突，Docker 适合服务器部署
📝 作业
- 基础题（难度⭐）：在你电脑上安装 Hermes Agent，运行
hermes doctor确认全部 ✅。 - 进阶题（难度⭐⭐）：使用 Docker 方式部署 Hermes Agent，配置持久化存储，确保重启后数据不丢失。
- 挑战题（难度⭐⭐⭐）：编写一个自动化安装脚本，检测环境、选择安装方式、自动配置，实现一键部署。
