Hermes Agent Mac 本地安装指南：按官方文档从 0 到可聊天

这篇适合谁

如果你想在 Mac 本地先把 Hermes Agent 跑起来，而不是先接 Telegram、Discord 或远程服务器，这篇可以直接按官方文档路径完成第一轮安装和启动。

Mac 本地安装命令

Hermes Agent 官方安装页给出的 macOS / Linux / WSL2 一键命令是：

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

官方说明里提到，这个安装器会自动处理大部分依赖，包括：

• Python 3.11
• Node.js
• ripgrep
• ffmpeg
• 虚拟环境
• hermes 命令本身

前提只有一个：先确认 git 在你的 Mac 上可用。

安装完成后怎么启动

官方文档建议安装完成后先刷新 shell：

source ~/.zshrc

然后直接启动：

hermes

如果你更喜欢 TUI 界面，也可以用：

hermes --tui

第一次必须先做什么

Hermes 官方快速开始里明确强调，最重要的不是先加功能，而是先跑通一次正常对话。第一步建议执行：

hermes model

这里用来选择模型提供商和模型。官方列出的常见提供商包括：

• OpenAI
• Anthropic
• OpenRouter
• GitHub Copilot
• Hugging Face
• DeepSeek
• 自定义 OpenAI 兼容端点

零基础用户最稳的顺序

按官方 Quickstart，建议顺序是：

1. 先安装 Hermes
2. 执行 hermes model 选择模型
3. 启动 hermes 或 hermes --tui
4. 先完成一轮正常聊天
5. 确认没报错后，再去加网关、自动化、技能或语音

官方原话的核心意思是：如果 Hermes 连一轮正常对话都跑不通，就不要先叠加更多功能。

如果安装后命令找不到

官方安装文档里给出的排查方式是：

• 先重新加载 shell：source ~/.zshrc
• 如果仍然提示 hermes: command not found，再继续看 PATH 或执行 hermes doctor

常见诊断命令：

hermes doctor

这篇的最短结论

如果你只是想在 Mac 上本地把 Hermes 跑起来，先不要分神去配更多平台。最短路径就是：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc
hermes model
hermes

来源： Hermes Agent 官方文档
原始文档： Installation / Quickstart
原文链接： https://hermes-agent.nousresearch.com/docs/getting-started/installation
补充链接： https://hermes-agent.nousresearch.com/docs/getting-started/quickstart