跳转到内容
Hermes Agent 中文教程

Day 1 · 安装 Hermes，说出第一句话

今日目标

Section titled “今日目标”

运行 hermes 或 hermes --tui，Hermes 能正常回复你的第一条消息。

前置条件

Section titled “前置条件”

唯一要求：已安装 Git。

安装器会自动处理其余所有依赖：Python 3.11（通过 uv，无需 sudo）、Node.js v22、ripgrep、ffmpeg。你不需要预先安装它们。

Terminal window
git --version   # 有输出即可，版本不限

如果提示 command not found，先安装 Git：

Terminal window
# macOS
brew install git
# 或 Xcode 命令行工具（无需 Homebrew）
xcode-select --install


# Ubuntu / Debian / WSL2
sudo apt update && sudo apt install git


# Fedora / RHEL
sudo dnf install git

步骤

Section titled “步骤”

  1. 一键安装

    复制这条命令，粘贴到终端回车：

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

    安装器会依次完成：下载依赖、克隆仓库、创建虚拟环境、将 hermes 注册到全局 PATH。整个过程约 1–3 分钟，取决于网络速度。

  2. 刷新 shell

    安装完成后，终端会提示你执行：

    Terminal window
    source ~/.bashrc   # bash 用户
    # 或
    source ~/.zshrc    # zsh 用户（macOS 默认）

    刷新后，hermes 命令才会在 PATH 里生效。

  3. 选择 Provider

    这是最关键的一步。运行交互式向导选择 LLM 提供商和模型：

    Terminal window
    hermes model
    情况推荐选择
    第一次用，想最快跑起来Nous Portal 或 OpenRouter
    已有 Anthropic API KeyAnthropic（Claude）
    已有 OpenAI API KeyOpenAI Codex
    想用本地模型Ollama 或自定义 OpenAI 兼容端点

  4. 第一次对话

    有两种界面，选你喜欢的：

    Terminal window
    hermes          # 经典 CLI
    hermes --tui    # 现代 TUI（推荐，支持鼠标、弹窗、非阻塞输入）

    启动后你会看到 Hermes 的欢迎横幅，显示当前模型和可用工具。输入一条消息试试：

    你好，帮我检查一下当前目录里有什么文件。

    成功的标志：

    • 横幅里显示你刚才选好的 Provider 和模型
    • Hermes 正常回复，没有报错
    • 它能调用 terminal 工具执行你的请求

  5. 验证 session 恢复

    在退出 Hermes 之后，运行：

    Terminal window
    hermes --continue   # 恢复上一次的对话
    hermes -c           # 简写

    如果能回到刚才的对话，说明 session 持久化正常。这在后续多任务并行时很重要。

验证成果

Section titled “验证成果”

完成本章后，你应该能观察到：

$ hermes
Welcome to Hermes Agent v0.10.x
Provider: anthropic · Model: claude-opus-4.6
Tools: terminal, file, web_search ...


You: 你好
Hermes: 你好！我是 Hermes，有什么可以帮你的？

常见问题

Section titled “常见问题”