Hermes Agent Mac 本地安装指南:按官方文档从 0 到可聊天
编辑部 · 发布 2026/04/30 · 更新 2026/07/17

这篇教程按 Hermes Agent 官方文档整理,适合在 macOS 本地完成安装、选模型并跑通第一轮对话。

这篇适合谁
如果你想在 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.11Node.jsripgrepffmpeg- 虚拟环境
hermes命令本身
前提只有一个:先确认 git 在你的 Mac 上可用。
安装完成后怎么启动
官方文档建议安装完成后先刷新 shell:
source ~/.zshrc
然后直接启动:
hermes
如果你更喜欢 TUI 界面,也可以用:
hermes --tui
第一次必须先做什么
Hermes 官方快速开始里明确强调,最重要的不是先加功能,而是先跑通一次正常对话。第一步建议执行:
hermes model
这里用来选择模型提供商和模型。官方列出的常见提供商包括:
- OpenAI
- Anthropic
- OpenRouter
- GitHub Copilot
- Hugging Face
- DeepSeek
- 自定义 OpenAI 兼容端点
零基础用户最稳的顺序
按官方 Quickstart,建议顺序是:
- 先安装 Hermes
- 执行
hermes model选择模型 - 启动
hermes或hermes --tui - 先完成一轮正常聊天
- 确认没报错后,再去加网关、自动化、技能或语音
官方原话的核心意思是:如果 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