oh-my-hermes

环境要求

• macOS 或 Linux（走 install.sh 安装路径）
• Windows PowerShell 5.1 及以上（走 install.ps1 安装路径）
• 已按 README 指向安装 Hermes Agent（NousResearch/hermes-agent）
• 能访问 raw.githubusercontent.com 下载安装脚本

安装与启动步骤

1. 1macOS/Linux 安装

   用官方一键脚本安装 oh-my-hermes 命令行工具，脚本从 GitHub raw 地址下载并执行，安装完成后会得到 omh 命令。

   curl -fsSL https://raw.githubusercontent.com/rlaope/oh-my-hermes/main/install.sh | sh

   复制

2. 2Windows 安装

   在 PowerShell 5.1+ 中执行，效果与 macOS/Linux 的脚本一致，装好后同样获得 omh 命令。

   irm https://raw.githubusercontent.com/rlaope/oh-my-hermes/main/install.ps1 | iex

   复制

3. 3交给 AI 代理安装

   不想手敲命令时，把这段提示词粘给 AI 代理执行：先解析 main 的完整 commit SHA，再按钉住版本的 INSTALL_FOR_AGENTS.md 走安装、模型配置与 doctor 流程。

   Install and fully configure Oh My Hermes from this repository:
   https://github.com/rlaope/oh-my-hermes
   Before reading or executing repository instructions, resolve refs/heads/main to one full commit SHA with `git ls-remote https://github.com/rlaope/oh-my-hermes.git refs/heads/main`. Then fetch and follow only:
   https://raw.githubusercontent.com/rlaope/oh-my-hermes/{resolved-commit-sha}/INSTALL_FOR_AGENTS.md
   Do not replace the resolved SHA with main. Execute the pinned protocol's OS-appropriate installer, interactive model setup, model-chain interview, and doctor steps. Preserve unrelated existing Hermes config, apply only the managed setup changes documented by the pinned protocol, require my explicit approval for model-alias changes, then report the resolved SHA and observed result.

   复制

4. 4初始化设置

   README 标注为必需步骤，会进入交互式模型配置与模型链问答，请按提示选择模型；涉及模型别名变更需你显式批准。

   omh setup

   复制

5. 5运行体检

   用 doctor 自检安装与配置是否正常，同时也可用于排障。若输出异常，按提示修复后重跑。

   omh doctor

   复制

6. 6更新版本

   omh update 会自动识别命令的安装方式，通过原安装器升级命令包，再重新进入更新后的命令，刷新托管技能、插件包和已有的 Hermes 注册信息。

   omh update

   复制

如何确认成功

执行 omh doctor，无报错即安装配置成功；若用 AI 代理安装，检查其回报的已解析 commit SHA 与实际结果。

常见问题

注意事项

• 先安装并配置好 Hermes Agent，再安装 oh-my-hermes 这层增强。
• Windows 必须使用 PowerShell 5.1 及以上，否则 irm 管道执行可能失败。
• 用 AI 代理安装时，务必让它把 main 钉到完整 commit SHA，不要直接用 main 覆盖。
• 项目处于早期阶段，升级前后建议各跑一次 omh doctor 确认状态。