准备工作
Last updated on
想顺利用上 Hermes，先确认平台支持、运行环境和模型 provider。先把前提条件准备好，再继续安装。
这一页先做三件事
第一次接 Hermes，不要先急着安装。
这一页只先解决 3 个前提：
- 确认你的系统是不是 Hermes 支持的环境
- 决定你准备用哪个模型 provider
- 理解 Hermes 第一次使用时，哪些高级功能现在先不用碰
把这 3 件事理顺，再继续安装，会清楚很多。
先确认 Hermes 适不适合你
Hermes 更适合这几类人：
- 希望 Agent 运行在自己环境里，而不是只用网页聊天框
- 希望自由切换 provider 和模型，不被单一平台绑定
- 想继续往记忆、技能、消息平台、定时任务这些方向深入
如果你现在只是想先体验最轻量的终端 AI 编程工具，Claude Code 或 OpenCode 那类产品通常上手会更轻。
而 Hermes 更像是一个可扩展、能力更完整的 Agent 系统。
先确认你的运行环境是不是支持
这一步非常重要，尤其是 Windows 用户
Hermes 官方当前支持的重点平台是 Linux、macOS、WSL2，以及 Android 上通过 Termux 使用。
原生 Windows 不是官方支持的主安装路径。1. 如果你是 Windows 用户，优先确认自己是否已经有 WSL2
Hermes 官方文档明确建议 Windows 用户通过 WSL2 使用，而不是直接走原生 Windows。
所以如果你现在是 Windows 环境，先不要默认自己能像普通 .exe 一样直接装好用上。
先确认：
- 你是否已经安装 WSL2
- 你是否知道后面会在 WSL2 终端里安装 Hermes
2. 如果你是 Linux 或 macOS，确认自己能正常使用终端
对 Linux 和 macOS 用户来说，第一次接入更直接。
你只需要确认：
- 自己能正常打开终端
- 终端里可以联网下载依赖
- 后面准备在哪个目录里使用 Hermes
3. 先别把消息平台、语音、MCP 这些高级能力混进第一次接入里
Hermes 功能很多，但第一次跑通主线时，你现在真正需要的只有：
- 能安装
- 能选 provider 和模型
- 能启动 CLI
- 能完成第一次正常对话
消息网关、语音、技能市场、MCP、Cron 这些内容，等主线跑通后再看，更顺。
再决定你准备用哪个 provider
安装前其实还要先确认一个基础前提
官方安装文档里把 Git 作为一键安装路径下需要先具备的基础依赖。
Python、Node.js、ripgrep、ffmpeg 这类运行依赖，官方安装脚本通常会自动处理。
Hermes 本身不是模型。
所以你第一次接入前，必须先知道：后面你到底准备让它调用谁的模型。
1. 先确认你手里有没有可用的 provider 账号或 API Key
Hermes 官方支持很多 provider，包括：
- Nous Portal
- OpenRouter
- Anthropic
- OpenAI 兼容接口
- 其他兼容端点
第一次使用时，不需要追求 provider 越多越好。
先准备一个你自己已经能正常调用的 provider 就够了。
2. 先准备好 API Key 或登录方式
不同 provider 的接入方式不完全一样：
- 有些走 API Key
- 有些可能走 OAuth 或设备登录
所以现在先确认：
- 你已经有可用账号
- 你知道后面会用 API Key 还是交互式登录
3. 先记住一个关键点：Hermes 对模型上下文长度有硬性要求
Hermes 官方文档明确提到：主模型至少要有 64K context。
这个限制会直接影响你能不能顺利启动
如果你后面选的模型上下文太小，Hermes 可能会在启动阶段直接拒绝，而不只是“体验差一点”。
这一步做完，什么状态算合格
满足下面这 3 条，就说明准备阶段完成了
- 你已经确认自己所在平台适合安装 Hermes
- 你已经决定好第一次接入要用哪个 provider
- 你知道第一次先只跑 CLI 主线，不急着碰消息平台和其他进阶能力
做到这里，准备阶段就完成了。
下一页继续看 安装 Hermes。