Agent-Reach icon indicating copy to clipboard operation
Agent-Reach copied to clipboard

docs: add Hermes Agent setup guide (#317)

Open Gigisanta opened this issue 2 months ago • 1 comments

What

Closes #317 by adding Hermes Agent to the English README:

  1. 'Works with any Agent' table (line 55) — adds Hermes Agent alongside Claude Code, OpenClaw, Cursor, Windsurf.
  2. Quick Start prompt (line 87) — adds Hermes Agent to the example agent list.
  3. 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_servers in ~/.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/, branch feat/hermes-setup-docs
  • Diff: +77 / -2 lines in docs/README_en.md only (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.md if requested in a follow-up PR

Gigisanta avatar Jun 08 '26 04:06 Gigisanta

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:

  1. pipx install agent-reach doesn'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.
  2. 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.
  3. 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.

Panniantong avatar Jun 10 '26 08:06 Panniantong