Skip to content

docs: add Hermes Agent integration page#55

Merged
tristantelleb merged 5 commits into
mainfrom
docs/hermes-integration
Jun 19, 2026
Merged

docs: add Hermes Agent integration page#55
tristantelleb merged 5 commits into
mainfrom
docs/hermes-integration

Conversation

@tristantelleb

@tristantelleb tristantelleb commented Jun 18, 2026

Copy link
Copy Markdown
Member

Summary

Adds an integration guide for Hermes Agent (Nous Research) — a self-hosted, persistent AI agent — configured to route through Eden AI's OpenAI-compatible endpoint.

Also introduces a new Autonomous Agents nav category and moves Hermes + OpenClaw into it, separating them from the interactive Coding Agents.

Changes

  • New page v3/integrations/hermes.mdx + logo integration-logo/hermes-icondoc.svg
  • New nav group "Autonomous Agents" (docs.json) containing hermes and openclaw
  • OpenClaw (openclaw.mdx): updated articleSection to "Autonomous Agents" and refreshed Next Steps cross-links

Verified end-to-end (Hermes CLI v0.16.0)

I installed Hermes locally and tested the documented flow against the live Eden AI API:

Check Result
hermes config set custom provider, base_url=https://api.edenai.run/v3
Auth via host-derived EDENAI_API_KEY ✅ authenticated
model.default = @edenai 400 — smart router selected non-function-calling models; Hermes always sends tools
model.default = anthropic/claude-sonnet-4-5 ✅ returned a completion

The page reflects these findings: it recommends a function-calling model as the default, documents the correct config paths (%LOCALAPPDATA%\hermes\ on Windows, ~/.hermes/ on macOS/Linux) and the host-derived key mechanism, and includes a troubleshooting entry for the @edenai + tools failure.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Added comprehensive Hermes Agent integration guide with setup instructions and troubleshooting.
    • Updated OpenClaw integration documentation with revised configuration approach and model selection guidance.
    • Reorganized integrations navigation to create a new "Autonomous Agents" section for improved discoverability.

Add an integration guide for Hermes Agent (Nous Research), a self-hosted
persistent AI agent, configured to route through Eden AI's OpenAI-compatible
endpoint. Verified end-to-end against the installed CLI (v0.16.0):

- custom provider with base_url https://api.edenai.run/v3
- key auto-derived from host as EDENAI_API_KEY
- recommends a function-calling model (anthropic/claude-sonnet-4-5); documents
  why @edenai smart routing fails for an agent that always sends `tools`

Group Hermes and OpenClaw under a new "Autonomous Agents" nav category,
separate from the interactive Coding Agents, and update OpenClaw's
articleSection and cross-links accordingly.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jun 18, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@tristantelleb, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 59 minutes and 3 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 6ff31a3a-1fb2-441a-b2ae-2c8a882ba665

📥 Commits

Reviewing files that changed from the base of the PR and between fbe1437 and a57b91d.

📒 Files selected for processing (2)
  • v3/integrations/hermes.mdx
  • v3/integrations/openclaw.mdx

Walkthrough

Adds a new hermes.mdx documentation page for the Hermes Agent integration with Eden AI, covering installation, provider configuration, model selection, fallback setup, and troubleshooting. Updates openclaw.mdx to replace the @edenai smart-router with an explicit anthropic/claude-sonnet-4-5 model id. Reorganizes docs.json navigation by introducing a new "Autonomous Agents" group containing both Hermes and OpenClaw pages.

Changes

Hermes Agent integration and nav reorganization

Layer / File(s) Summary
New Hermes Agent documentation page
v3/integrations/hermes.mdx
New MDX page with frontmatter, TechArticleSchema metadata, function-calling requirement note, step-by-step setup (install, hermes config set, API key), start commands, model-selection table, fallback configuration, troubleshooting subsections for 401/tool-support/model not found/connection errors, and next-steps links.
Navigation restructuring and OpenClaw model config updates
docs.json, v3/integrations/openclaw.mdx
docs.json gains a new "Autonomous Agents" nav group (robot-astromech icon) containing hermes and openclaw, removing openclaw from "Coding Agents". openclaw.mdx replaces all @edenai smart-router references with the explicit anthropic/claude-sonnet-4-5 provider/model id across the config snippet, wizard instructions, model table, and troubleshooting; next steps swap "Cline" for "Hermes Agent".

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐇 A new agent named Hermes has joined the fold,
With provider/model configs clearly told.
The smart-router's gone, replaced with precision,
And nav groups now aid the reader's decision.
OpenClaw and Hermes, side by side they stand —
Autonomous agents, just as planned! 🤖

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The PR title accurately summarizes the primary change: adding a new Hermes Agent integration documentation page, which is the main focus of the changeset.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/hermes-integration

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@mintlify

mintlify Bot commented Jun 18, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
edenai 🟢 Ready View Preview Jun 18, 2026, 9:20 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Verified that @edenai + a tools parameter returns 400 ("providers do not
support function calling"), so the smart router is unusable for agents that
always send tools. Remove all @edenai references from the Hermes and OpenClaw
pages and default both to a function-calling model (anthropic/claude-sonnet-4-5).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
tristantelleb and others added 2 commits June 19, 2026 10:12
…ack command

- Choosing-a-model "Maximum capability" -> anthropic/claude-opus-4-8 (4-7 superseded; 4-8 is live and newer in the Eden AI catalog)
- about="Autonomous AI Agents" on hermes + openclaw (was the stale Coding Agents value left over after moving both pages to the Autonomous Agents section)
- Set up a fallback: use `hermes fallback add` (bare `hermes fallback` only lists the chain; verified against Hermes v0.16.0)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@tristantelleb tristantelleb merged commit 393af7f into main Jun 19, 2026
5 of 6 checks passed
@tristantelleb tristantelleb deleted the docs/hermes-integration branch June 19, 2026 08:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant