资料核对日期:2026-11-16;未做本地安装实测。本文采用 Linux、macOS 与 WSL2 的命令行路线,目标是确认 Hermes 的基础依赖可用、Provider 配置能够完成一次联网对话,并执行首个可验证任务。官方源码安装脚本跟踪 main 分支,因此不应将其等同于固定稳定版本;后续操作应以官方文档当前版本为准。
准备条件
POSIX 源码脚本需要 Git、curl、tar 和 SHA-256 工具,Hermes 要求 Python 3.14(>=3.14,<3.15)。源码脚本会通过 PM 准备运行时,不要用 pip install hermes-agent 替代受管理的安装方式。
如果尚未安装,执行官方命令:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
安装完成后重新加载 shell:
source ~/.bashrc # 或:source ~/.zshrc
还需准备可用的 Provider 账号、订阅或 API 密钥,并保证当前环境能够访问对应服务。示例密钥只是格式说明,不能直接作为实际配置值。所选模型至少需要 64,000 token 的上下文窗口,否则 Hermes 会在启动时拒绝该模型。
验收依赖与命令入口
先运行诊断命令:
hermes doctor
该命令用于报告缺少的组件、配置问题及建议修复方式。这里不预设固定的“OK”项目或输出颜色,因为官方资料没有给出统一输出模板。预期结果是诊断完成,且不存在阻止普通对话启动的未解决问题。
如果终端提示 hermes: command not found,先重新加载 shell;仍未恢复时检查 PATH。POSIX 源码脚本的命令入口通常是 ~/.local/bin/hermes 包装器,但不应绕过包装器去硬编码虚拟环境中的可执行文件。
配置 Provider 并验证网络
运行交互式模型配置:
hermes model
在界面中选择实际使用的 Provider 和模型,并按提示完成 OAuth 或提交真实密钥。不要把 sk-or-... 等占位符写入配置。若使用 Nous Portal,也可选择官方提供的快速路径:
hermes setup --portal
它会完成登录、将 Nous 设置为 Provider,并开启 Tool Gateway。本文不使用额外的 curl 请求探测第三方 API;Provider 认证和网络是否可用,直接通过下一步真实对话判断,避免引入未被当前资料支持的端点、请求头或测试参数。
执行首个任务
启动经典 CLI:
hermes
进入会话后输入一个范围明确、结果容易核对的任务:
Check my current directory and tell me what looks like the main project file.
成功验收应同时满足:欢迎横幅显示所选模型和 Provider;Hermes 能够无错误回复;任务需要时可以调用终端或读取文件;对话可以继续进行超过一轮。Hermes 给出的“主要项目文件”判断还应与当前目录实际内容相符,不能只以出现一段文本作为成功依据。
相关失败场景
如果 Hermes 能启动,但回复为空、异常,或无法完成模型请求,优先重新运行:
hermes model
重新确认 Provider、模型和认证信息,再回到普通对话复测。若 hermes doctor 标记配置问题,应先修复缺失或过期的配置,不要继续添加 gateway、skills、cron 或路由。只有基础对话能够稳定完成后,才算通过本次依赖、网络与首个任务验收。