Hermes 教程 01:安装与快速入门

难度:⭐ 入门 | 预计时间:10 分钟 | 适配版本:v0.13.0


系统要求

  • 操作系统:Linux、macOS、Windows WSL2
  • 依赖:Python 3.10+、Git
  • 可选:Docker(远程后端模式)
  • 注意 :WSL2 建议启用 systemd=true(/etc/wsl.conf),否则后台服务在关闭窗口后会终止

安装流程

安装脚本
依赖检测
环境配置
健康检查
是
否
通过
失败

  1. 运行安装脚本

curl | bash
2. 自动检测依赖

Python/Git
3. 依赖满足?
4. 写入 ~/.hermes/

config.yaml & auth
5. 提示安装依赖
6. 运行 hermes doctor
7. 健康检查结果
✅ 安装完成
查看错误信息

步骤详解

Step 1:运行安装脚本

bash 复制代码
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Step 2:首次配置(交互式向导)

bash 复制代码
hermes setup

向导会依次询问:

  • 选择模型提供商(OpenRouter / Anthropic / DeepSeek / MiniMax 等)
  • 输入 API Key
  • 选择终端后端(local / docker / ssh / modal / daytona)
  • 启用哪些工具集(web / terminal / file / vision 等)

v0.13.0 推荐认证方式 :使用 hermes auth 命令管理凭证,替代手动编辑 .env:

bash 复制代码
# 添加 API Key(推荐方式)
hermes auth add openrouter --api-key sk-or-xxxxx
hermes auth add anthropic --api-key sk-ant-xxxxx
hermes auth add minimax-cn --api-key xxxxx

# 查看所有认证状态
hermes auth list

# 查看特定提供商
hermes auth status openrouter

Step 3:验证安装

bash 复制代码
hermes doctor

输出示例:

复制代码
✅ Python 3.12.3
✅ Git installed
✅ Config valid
✅ API key configured
✅ Tools: web, terminal, file, vision, ...

首次使用

交互模式(推荐新手)

bash 复制代码
hermes

进入交互界面后直接对话:

复制代码
You: 帮我解释什么是 Skills 系统
Hermes: [回复内容]

单次查询模式

bash 复制代码
hermes chat -q "What is the capital of France?"

纯文本一次性输出(v0.12+)

bash 复制代码
hermes -z "解释量子计算"

-z 模式输出纯文本,无交互元素、无加载动画,适合脚本管道使用。

指定模型

bash 复制代码
hermes chat -q "解释量子计算" -m anthropic/claude-sonnet-4

恢复会话

bash 复制代码
hermes --continue                    # 恢复最近会话
hermes --resume 20260225_143052_a1b2c3   # 恢复指定会话

查看配置

bash 复制代码
hermes config show
hermes config path                   # 查看配置文件路径
hermes config env-path              # 查看 .env 路径

目录结构

复制代码
~/.hermes/
├── config.yaml           # 主配置文件
├── .env                  # API Keys 和密钥(legacy,推荐用 hermes auth)
├── skills/               # 安装的技能
├── sessions/             # 会话记录
├── state.db              # SQLite 会话存储
├── checkpoints/          # 文件系统快照(用于 /rollback)
├── state-snapshots/      # 状态快照
├── logs/                 # 日志文件
│   ├── agent.log         # Agent 活动日志
│   ├── errors.log        # 警告和错误
│   └── gateway.log       # 网关活动日志
├── hermes-agent/         # 源码(git 安装时)
├── plugins/              # 第三方插件(v0.13.0+)
│   └── model-providers/  # 提供商插件目录
└── backups/              # 备份文件

全局选项速查

选项 说明
--version, -V 显示版本
--profile <name>, -p 选择 Profile
--resume <session>, -r 恢复指定会话
--continue, -c 恢复最近会话
--worktree, -w 隔离 git worktree 模式
--yolo 跳过危险命令确认
--ignore-user-config 忽略用户配置
--ignore-rules 跳过自动注入规则

常见问题

问题 解决
command not found: hermes 重启终端,或检查 PATH 是否包含 ~/.local/bin
hermes doctor 报 Python 版本低 升级到 Python 3.10+
API Key 无效 使用 hermes auth add <provider> --api-key <key> 重新添加
OAuth 未登录警告 非阻塞问题,使用 MiniMax-CN 等无需 OAuth 的提供商可忽略
Skills Hub rate limit 在 .env 中加 GITHUB_TOKEN=...(可选优化)

下一步

  • 前往下一节学习 config.yaml 各项配置
  • 或运行 hermes model 切换模型提供商
相关推荐
罗西的思考2 小时前
【轻量化复刻大模型 / KIMI K3】Muon 优化器及 训练系统
人工智能·算法·机器学习
屿华AI2 小时前
AUTOSAR 实战-诊断工具 | 用 Claude Code 开发诊断测试工具:AI 协作开发实践
人工智能·测试工具
程序员韩星3 小时前
OpenAI 兼容接口返回 404,先查请求地址,再查模型名
前端·人工智能·http
Cosolar3 小时前
2026 年 Java AI Agent 生态全景盘点:50+ Java 开源项目的分类、实测与选型判断
人工智能·架构·agent
花椒技术3 小时前
从“实时生成游戏”出发,我们用 AI 做了四次游戏开发尝试
人工智能·aigc·游戏开发
其实防守也摸鱼4 小时前
用 Claude Code 重构遗留系统:从评估到落地的完整指南
前端·网络·人工智能·chrome·安全·重构
泯泷4 小时前
当"孤独的开发者"成为常态,AI正在悄悄杀死那个我们熟悉的互联网
人工智能·chatgpt·llm
黑客笔记4 小时前
安全态势感知中的资产失陷排名思考
人工智能·算法·网络安全
用户2707059662594 小时前
Copilot平替方案怎么选:主流工具横向对比
人工智能
好悬给我拽开线4 小时前
EasyHeC++ 用预训练图像模型实现全自动手眼标定
人工智能