快速开始 | Harmes

教程概述

本教程将帮你在 5 分钟内完成 Hermes Agent 的本地启动。我们会从环境检查开始，逐步引导你完成依赖安装、配置文件、启动服务等关键步骤，让你快速看到第一个 AI Agent 跑起来的效果。

开始前请确认满足以下条件

完成本教程后你将能够

1
检查 Node.js 版本
Hermes Agent 要求 Node.js 18 及以上版本，请先确认本地环境是否满足要求。
bash
```
node -v
npm -v
```
小贴士：如果版本过低，建议使用 nvm 安装最新的 LTS 版本。
2
克隆项目仓库
从 GitHub 拉取 Hermes Agent 源代码到本地。
bash
```
git clone https://github.com/NousResearch/Hermes-Agent.git
cd Hermes-Agent
```
3
安装项目依赖
使用 npm 安装所有运行时与开发依赖，过程大约需要 1-2 分钟。
bash
```
npm install
```
注意：若遇到网络问题，可设置国内镜像：npm config set registry https://registry.npmmirror.com
4
配置环境变量
复制 .env.example 为 .env，并填入你的 API 密钥。这是 Agent 调用模型的关键凭证。
bash
```
cp .env.example .env

# 编辑 .env 文件
OPENAI_API_KEY=sk-xxxx
MODEL_NAME=gpt-4o-mini
```
小贴士：建议先用便宜的模型（如 gpt-4o-mini）测试，跑通后再切换到 gpt-4o。
5
启动开发服务器
运行以下命令启动 Agent，启动成功后会在控制台看到访问地址。
bash
```
npm run dev
```
6
进行第一次对话
打开浏览器访问 http://localhost:3000，在对话框中输入 “你好，介绍一下你自己”，Agent 会基于配置的模型给出回复。

通常是依赖没有安装完整。请删除 node_modules 与 package-lock.json，再重新执行 npm install。

请检查 .env 中的 OPENAI_API_KEY 是否正确，并确认账号是否有可用额度。

可以通过 PORT=3001 npm run dev 指定其它端口，或者关闭占用 3000 的进程。

恭喜你完成了 Hermes Agent 的第一次启动！下一步建议进入「基础配置」教程，学习如何切换模型、调整提示词以及定制基础行为。