Skip to content
FunCoding

Search

Search docs, agents, posts, Skills and MCP servers

Hermes Agent 快速上手:安装、选择模型和第一次对话

安装 Hermes Agent 的几种方式、用 hermes model 选择服务商、密钥和配置分别存在哪里,以及日常最常用的一组命令。

安装

桌面安装包(macOS / Windows)

到 Hermes 官网下载对应平台的安装包,里面同时包含命令行和桌面应用。macOS 版只支持 Apple Silicon。

只装命令行

Linux / macOS / WSL2:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows(PowerShell):

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

装完重新加载 shell:

source ~/.bashrc   # zsh 用户改成 source ~/.zshrc

之后想补装桌面应用,运行 hermes desktop。

安装脚本会拉取源码并自动准备 Python、Node.js 等依赖,默认还会装浏览器工具和电脑操作驱动。不想要的话加参数 --skip-browser、--skip-computer-use(Windows 是 -SkipBrowser、-SkipComputerUse)。

Android 设备用 Termux 的 APT 包,不要用上面的脚本。

选择模型

这是最重要的一步:

hermes model

它会交互式地让你选服务商、填凭据、选模型。全新安装时也可以运行 hermes setup,有三种模式:

模式说明
Quick Setup用 Nous Portal 账号登录,不用管理 Key
Full Setup自己逐项选择服务商、工具和选项,用自己的 Key
Blank Slate只开启运行所需的最少功能,其余全部关闭,之后按需开启

各家模型在 hermes model 里怎么选,见官方文档。

模型上下文至少要 64K token,否则启动时会被拒绝。本地模型记得把上下文大小设到 64K 以上。

配置存在哪里

内容位置
密钥和令牌~/.hermes/.env
其他设置~/.hermes/config.yaml

最稳妥的修改方式是用命令,而不是手改文件:

hermes config set model.default <模型名>
hermes config get model
hermes config edit

第一次对话

hermes

界面底部会显示当前使用的模型、token 用量和响应时间。发一句话,能回复就说明配置没问题。

官方的建议是:先让一次普通对话跑通,再去加网关、定时任务、技能这些功能。

常用命令

命令作用
hermes开始新的对话
hermes --tui用新版 TUI 启动
hermes "一句话"发送单条消息
hermes -c恢复上一次会话
hermes model切换服务商和模型
hermes tools管理启用的工具
hermes gateway setup配置聊天平台
hermes doctor诊断连接问题
hermes update升级

接入聊天平台

命令行能正常对话之后:

hermes gateway setup

按提示连接 Telegram、Discord、Slack、WhatsApp 等平台。