返回
Hermes Agent 教程系列 开发工具

Hermes Agent 教程 1：前 5 分钟 — 安装与快速体验

5 分钟安装 Hermes Agent 并获得首次响应。涵盖快速安装脚本、设置向导、模型选择和验证。无需任何前置知识。

教程概述

系列索引: Hermes Agent 教程系列

这是 Hermes Agent 教程系列的第一篇文章。只需 5 分钟，你就能完成 Hermes 的安装、配置，并获得首次响应。

你将学到什么

  • ✅ 如何在 Linux/macOS/WSL2 上安装 Hermes Agent
  • ✅ 如何运行设置向导
  • ✅ 如何选择你的第一个模型
  • ✅ 如何通过测试交互验证安装

为什么快速入门很重要

大多数 AI 助手需要漫长的设置过程才能试用。Hermes Agent 的设计理念不同：安装 → 设置 → 首次响应，全程不到 5 分钟。

flowchart LR
    A[curl 安装] --> B[hermes setup]
    B --> C[选择模型]
    C --> D[hermes]
    D --> E[首次响应]

    style A fill:#e8f5e9
    style E fill:#fff3e0

与其他 Agent 对比

Agent 安装方式 设置时间 首次响应
Hermes 1 条命令 2 分钟 < 5 分钟
Claude Code npm install 3-5 分钟 即时
Cursor IDE 下载+配置 5-10 分钟 即时

安装

一条命令安装

Hermes Agent 使用单一的 curl 脚本，自动处理平台检测和依赖设置：

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

支持的系统：

  • Linux（Ubuntu、Debian、Arch、Fedora）
  • macOS（Intel 和 Apple Silicon）
  • Windows WSL2
  • Android via Termux

安装后步骤

重新加载 shell 以获取新的 hermes 命令：

source ~/.bashrc    # 或: source ~/.zshrc

验证安装

hermes --version

预期输出：Hermes Agent v1.x.x

设置向导

Hermes 包含交互式设置向导，引导你完成初始配置：

hermes setup

向导涵盖：

  1. 模型提供商选择 — 选择 LLM 来源
  2. API 密钥输入 — 安全存储你的凭证
  3. 基本偏好设置 — 设置默认行为

模型提供商选项

设置过程中，你将选择模型提供商：

提供商 可用模型 免费额度
Nous Portal Hermes 系列 有（受限）
OpenRouter 200+ 模型 有
OpenAI GPT-4o, GPT-4 无
Anthropic Claude 4 无

首次运行建议：选择 OpenRouter 并使用免费模型如 openrouter:auto，无需花费即可测试。

首次交互

设置完成后，启动 Hermes：

hermes

你将看到 TUI（终端用户界面）启动并显示提示符。

你的第一条消息

输入任意消息并按 Enter。Hermes 将使用你配置的模型响应。

示例交互：

你: Hello, what can you help me with?

Hermes: Hello! I'm Hermes Agent, your self-improving AI assistant. I can help you with:
- Answering questions and providing information
- Writing code and debugging
- Creating and managing tasks
- Learning your preferences over time

What would you like to explore?

快捷命令

尝试这些斜杠命令：

命令 用途
/help 显示可用命令
/model 查看/更换当前模型
/usage 检查 token 使用量
/exit 退出 Hermes

常见问题排查

问题 1: hermes: command not found

原因：安装后未重新加载 shell。

解决方案：

source ~/.bashrc
# 或重启终端

问题 2: API 密钥错误

原因：所选提供商缺少或无效的 API 密钥。

解决方案：重新运行 hermes setup 并输入有效密钥。

问题 3: 模型无响应

原因：速率限制或网络问题。

解决方案：

  1. 使用 /usage 检查速率限制
  2. 尝试不同模型：/model openrouter:auto
  3. 检查网络连接

总结

你已完成 Hermes Agent 快速入门：

  1. 已安装：通过 curl 脚本
  2. 已配置：通过设置向导
  3. 已验证：通过首次交互

关键要点

  • ✅ Hermes 通过一条命令安装
  • ✅ 设置向导处理配置
  • ✅ 首次响应确认安装成功
  • ✅ 斜杠命令提供快捷控制

下一步

继续阅读 教程 2：记忆系统，了解 Hermes 独特的持久记忆和用户建模功能。

系列导航: