1 / 7
Day 1 教程信息图
💻
Day 1 7 天入门教程

安装 Hermes,说出第一句话

💻 Day 1

安装 Hermes,说出第一句话

🎯 今日目标: hermes version 有输出,且完成第一次对话
📑 本节内容
1 检查环境
2 一键安装
3 验证安装
4 运行诊断
5 运行配置向导
6 第一次对话
1

检查环境

Hermes 支持 Linux、macOS、WSL2。安装器会自动处理 Python 3.11 环境,唯一前置要求是 Git。Windows 原生不支持,请使用 WSL2。

terminal
$ python3 --version Python 3.11.8

若版本低于 3.10,请先安装新版本(推荐 pyenv 或 python.org 官方包)。

2

一键安装

官方推荐安装方式(官网验证):

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

安装器会自动处理平台特定配置,将 hermes 加入 PATH。

Android / Termux 用户:

Termux 需手动安装,使用 .[termux] extra(不含语音依赖)。详细步骤见官方 Termux 指南。

3

验证安装

terminal
$ hermes version hermes v0.10.0

显示版本号即安装成功。如果提示 command not found,执行 source ~/.bashrc(或 ~/.zshrc)刷新 shell。

4

运行诊断

首次使用前建议运行诊断,确认所有依赖正常:

terminal
$ hermes doctor

如有问题,按提示逐一修复,或查阅官方文档排查。

5

运行配置向导

交互式向导会引导你完成 provider、模型、工具等核心配置:

terminal
$ hermes setup

向导会生成 ~/.hermes/config.yaml 配置文件。Day 2 会详细讲解模型配置,如果网络不通可先跳过 provider 步骤。

6

第一次对话

直接运行 hermes 进入交互式 CLI:

terminal
$ hermes Welcome to Hermes Agent v0.10.0 Type your message or /help for commands You: 你好,Hermes Hermes: 你好!我是 Hermes,你的 AI 助手。有什么我能帮你的吗?

如果模型未配置,会提示你先设置 provider。这时按 Ctrl+C 退出,先完成 Day 2 的模型配置。

你将看到
$ hermes version hermes v0.10.0 $ hermes Welcome to Hermes Agent v0.10.0 Type your message or /help for commands You: 你好 Hermes: 你好!我是 Hermes,有什么可以帮你的?
⚠️ Python 版本过低

安装 Python 3.10+。推荐 pyenv:pyenv install 3.11 && pyenv global 3.11

⚠️ hermes: command not found

执行 source ~/.bashrc(或 ~/.zshrc)。如仍不行,检查 ~/.local/bin 是否在 PATH:export PATH="$HOME/.local/bin:$PATH"

⚠️ 安装脚本执行失败

检查网络能否访问 GitHub。如不能,尝试 pip install: python3 -m pip install hermes-agent

⚠️ hermes setup 卡住

按 Ctrl+C 退出,跳过 provider 配置。Day 2 手动配置模型。