Agent-Reach
Agent-Reach copied to clipboard
docs: add Hermes Agent setup guide (#317)
What
Closes #317 by adding Hermes Agent to the English README:
- 'Works with any Agent' table (line 55) — adds Hermes Agent alongside Claude Code, OpenClaw, Cursor, Windsurf.
- Quick Start prompt (line 87) — adds Hermes Agent to the example agent list.
-
New FAQ entry — detailed Hermes setup section covering:
- One-line install (recommended path)
- Manual install with
pipx(matches Agent Reach's own installation model) - Natural-language trigger examples tuned for semantic activation
- MCP server wiring via
mcp_serversin~/.hermes/config.yaml - Per-profile token overrides (
~/.hermes/profiles/<name>/.env) - Known limitations on Hermes (voice mode, Telegram 4096-char limit, cron fit)
Why
Hermes Agent (https://hermes-agent.nousresearch.com) is a CLI-driven, local-first agent framework from Nous Research. Agent Reach's installer + doctor + config model maps 1:1 to Hermes's skills + MCP + profile architecture, so a dedicated section helps Hermes users discover Agent Reach without reading the whole README.
Verification
- Local clone at
~/.hermes/repos/agent-reach/, branchfeat/hermes-setup-docs - Diff:
+77 / -2lines indocs/README_en.mdonly (docs-only, no code changes) - Renders correctly in GitHub markdown (tested locally with
grip --export) - No other files modified; no test changes needed
Notes for reviewer
- I tried to match the existing FAQ voice (terse, instructional, with explicit commands)
- The MCP config snippet follows the exact
mcp_servers:schema Hermes uses (~/.hermes/config.yaml) - The 'Limitations' subsection is honest about edge cases (voice mode, Telegram) — not marketing fluff
- Happy to add a Chinese translation of the same section to
docs/README.mdif requested in a follow-up PR
Thanks for writing this guide — verified that Hermes Agent (NousResearch) is real and the integration idea makes sense. Three factual fixes are needed before this can merge:
-
pipx install agent-reachdoesn't work — the package isn't on PyPI; installation goes through the GitHub archive (see docs/install.md). The manual-install section would fail for every user as written. -
The auto-registration claim is not real — the guide says the skill is "auto-registered at
~/.hermes/skills/tools/agent-reach/" and that the installer recognizes Hermes, but there is zero Hermes support in the codebase (grep -ri hermes agent_reach/is empty). This section needs to be removed or rewritten as manual steps. - The channel list is outdated — WeChat, Weibo and Douyin were removed in v1.4.2 (#347), and Weibo was never Tier-0. Please align the channel list with the current README (13 platforms, 6 zero-config).
Happy to merge once these are corrected against v1.4.2.