Skip to content
← All guides

getting started · beginner

Hermes 上手指南：30 分钟拥有你的 AI 助手

面向非技术用户的 Hermes 中文入门指南：30 分钟完成安装、模型配置，并复现“精读论文 PDF → 生成 Word 笔记”的完整流程。

By Serena Wang

Hermes Agent hub →

What you’ll achieve

完成 Hermes 安装与模型配置，独立完成“拖入论文 PDF → 生成四项结构化笔记 → 输出桌面 Word 文档”的第一个真实任务。

Before you start

一台电脑（Windows 10/11 或 Apple Silicon Mac）；一个模型 API Key（推荐 DeepSeek）；约 30 分钟。

Verified

On this page

这份指南带你在 30 分钟内装好 Hermes——一个能记住你、能直接处理你电脑里的文件、还能定时帮你干活的 AI 助手。

开始前，你需要准备什么

  • 一台电脑：Windows 10/11 或 Mac 都可以（Mac 需是 M 系列芯片）
  • 一个模型 API Key：Hermes 是“外壳”，AI 的“大脑”需要单独配置。推荐 DeepSeek：国内直接注册充值，10 块钱能用很久。下面第 2 步手把手教
  • 大约 30 分钟：一次性配置，装好后永久可用

💡 什么是 API Key？可以理解为“AI 大脑的账号密码”。Hermes 本身免费开源，你付的钱是给模型供应商的“脑力使用费”，按用量计费，日常学习使用一个月通常几块钱到几十块钱。

一、安装 Hermes（5 分钟）

Windows（二选一）

方式 A：桌面版安装包（推荐，最省事）

  1. 打开 Hermes 官网下载页：https://hermes-agent.nousresearch.com
  2. 下载 Windows 版安装包，双击打开，按提示完成安装
  3. ✅ 检查点：开始菜单里能找到 Hermes，能打开桌面应用

方式 B：命令行安装

  1. 按 Win + X，选择“终端”或“PowerShell”，粘贴以下命令并回车：iex (irm https://hermes-agent.nousresearch.com/install.ps1)
  2. ✅ 检查点：安装完成后，重新打开一个终端窗口，输入 hermes --version 能看到版本号

Mac

  1. 打开“终端”（启动台搜索 Terminal），粘贴以下命令并回车：curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
  2. ✅ 检查点：输入 hermes --version 能看到版本号

二、配置模型（10 分钟，最关键的一步）

2.1 选一个模型，获取 API Key

Hermes 不绑定任何模型厂商，以下几家国内直接注册、微信/支付宝充值就能用，任选其一：

  • DeepSeek（推荐）：最便宜，10 元能用很久。Key 获取：platform.deepseek.com
  • Kimi（月之暗面）：长文本能力强，读文献好用。Key 获取：platform.moonshot.cn
  • 智谱 GLM：老牌国产，稳定性好。Key 获取：open.bigmodel.cn
  • 通义（阿里百炼）：阿里生态。Key 获取：bailian.console.aliyun.com

💡 已经在用 GPT / Claude 等其他模型？也可以在 Hermes 里直接接入你已有的 Key，步骤相同。注册后在“API Keys”页面创建 Key，复制并保存好（通常只显示一次）。建议先充 10 元。

2.2 把 Key 告诉 Hermes（二选一）

方式 A：在桌面 App 里配置（推荐）

  1. 打开 Hermes 桌面应用
  2. 进入 Settings（设置）→ Model / Capabilities
  3. 选择你的供应商（如 DeepSeek），粘贴 API Key，保存
  4. ✅ 检查点：设置页显示当前模型为你选的模型

方式 B：用命令行配置：运行 hermes model，按提示选择供应商、粘贴 Key 即可。

💡 两种方式是同一份配置——App 里配好，命令行也能用；以后想换模型，随时重走这一步。

三、第一次对话（2 分钟）

在桌面应用（或终端输入 hermes）发一句测试消息：

你好，请用一句话介绍你自己，并告诉我你现在用的什么模型。

✅ 检查点：它正常回复了，没有报错——恭喜你，最难的部分已经完成了

💡 日常更推荐用桌面版：界面和聊天软件一样，还能直接把文件拖进对话框。

四、完成你的第一个真实任务（10 分钟）

找一篇你正在读的论文 PDF（没有的话，任何一份报告 PDF 也行）：

  1. 在桌面应用里把 PDF 直接拖进对话框，发送：「精读这篇论文，按以下四项给我中文笔记：一、研究问题；二、研究方法；三、核心结论；四、对我的学习和研究有什么启示。」
  2. 等它读完（它会逐页解析全文，比聊天软件上传文件读得深得多），再追问一句：「把这份笔记保存成 Word 文档，放到我的桌面。」

✅ 检查点：桌面上出现了一个排好版的 Word 文档——这就是“能动手干活”和“只能聊天”的区别

五、卡住了怎么办

  • 输入 hermes 提示“不是内部或外部命令”：终端没刷新。关掉终端窗口，重新打开再试
  • 回复报 401 / unauthorized：API Key 没配对。重新配置模型，检查 Key 有没有多复制空格、账户有没有余额
  • 回复报网络错误 / timeout：网络问题。检查网络；如果选了国外模型供应商，换成 DeepSeek 等国内供应商
  • 安装卡住或下载特别慢：GitHub 在国内偶发波动。不需要 VPN，优先改用桌面版安装包（方式 A）；命令行安装卡住就等一会儿重试，脚本支持续装

六、下一步

装好只是开始。接下来你可以用它做更有意思的事：批量精读文献、用大白话让它跑数据分析、自动排出学校要求的论文格式……