Skip to content

docs: document Hermes Agent installation - #487

Merged
rapids-bot[bot] merged 3 commits into
NVIDIA:release/0.6from
bbednarski9:bbednarski/relay-529-document-hermes-setup-and-native-agent-install-steps
Jul 20, 2026
Merged

docs: document Hermes Agent installation#487
rapids-bot[bot] merged 3 commits into
NVIDIA:release/0.6from
bbednarski9:bbednarski/relay-529-document-hermes-setup-and-native-agent-install-steps

Conversation

@bbednarski9

@bbednarski9 bbednarski9 commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Overview

This PR documents the Hermes Agent installation prerequisite for NeMo Relay's native Hermes integration. It directs users to the official Hermes Agent installation guide so that platform-specific setup instructions remain aligned with the upstream project, and it adds a simple CLI verification step before users configure NeMo Relay.

  • I confirm this contribution is my own work, or I have the right to submit it under this project's license.
  • I searched existing issues and open pull requests, and this does not duplicate existing work.

Details

  • Link the Hermes section of the general NeMo Relay installation guide to the official Hermes Agent installation documentation.
  • State that Hermes Agent 0.18.2 or newer must be installed and that the hermes command must be available on PATH.
  • Add hermes --version as an explicit verification step in the dedicated Hermes Agent guide.
  • Preserve the existing nemo-relay install hermes and nemo-relay doctor --plugin hermes integration flow.
  • Keep platform-specific Hermes installation commands in the upstream Hermes documentation, where they can remain current independently of NeMo Relay releases.

Validation:

  • git diff --check
  • Fern configuration check: zero errors; one authentication-only redirect warning
  • Fern strict broken-link check: passed
  • Documentation style review: no must-fix or should-fix findings

This is a documentation-only change and introduces no breaking API or runtime behavior changes.

Where should the reviewer start?

Start with docs/nemo-relay-cli/hermes.mdx, which adds the Hermes prerequisite and CLI verification to the native integration workflow. Then review docs/getting-started/installation.mdx for the matching entry-point guidance.

Related Issues: (use one of the action keywords Closes / Fixes / Resolves / Relates to)

  • Closes RELAY-529

Summary by CodeRabbit

  • Documentation
    • Updated Hermes Agent installation requirements to version 0.18.2 or newer.
    • Added a prerequisite step to verify the Hermes CLI by running hermes --version in a newly opened shell.
    • Clarified the installation sequence: install the NeMo Relay CLI first, then run the Hermes user integration setup and diagnosis afterward.

Signed-off-by: Bryan Bednarski <bbednarski@nvidia.com>
@coderabbitai

coderabbitai Bot commented Jul 20, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Enterprise

Run ID: 43657a5f-4f51-4715-acfc-147b87eb3587

📥 Commits

Reviewing files that changed from the base of the PR and between c5c4be8 and 2dede93.

📒 Files selected for processing (1)
  • docs/getting-started/installation.mdx
📜 Recent review details
⏰ Context from checks skipped due to timeout. (2)
  • GitHub Check: Check / Run
  • GitHub Check: Preview docs
🧰 Additional context used
📓 Path-based instructions (7)
**/*.mdx

📄 CodeRabbit inference engine (.agents/skills/review-doc-style/SKILL.md)

MDX top-of-file SPDX comments must use {/* ... */} delimiters instead of HTML comment delimiters (Must-Fix)

In MDX files, top-of-file comments must use JSX comment delimiters ({/* to open and */} to close); do not use HTML comments for MDX SPDX headers

Files:

  • docs/getting-started/installation.mdx
**/*.{md,mdx}

📄 CodeRabbit inference engine (AGENTS.md)

Update README.md, fern/, package READMEs, and binding-support notes when public behavior, package names, examples, or supported bindings change.

**/*.{md,mdx}: Prefer the documented public API, not internal shortcuts
Keep package names, repo references, and build commands current
Keep release-process and release-notes guidance in repo-maintainer docs such as RELEASING.md, not as user-facing docs pages or CHANGELOG.md
Keep stable user-facing wrappers at scripts/ root in docs and examples; only point at namespaced helper paths when documenting internal maintenance work
When detailed dynamic plugin guides exist, keep Rust native plugin examples, Python worker plugin examples, and grpc-v1 protocol details on separate pages

If links in documentation change, run just docs-linkcheck.

Files:

  • docs/getting-started/installation.mdx
**/*.{md,markdown,mdx}

📄 CodeRabbit inference engine (CONTRIBUTING.md)

Add the SPDX license header to all Markdown/MDX documentation files using the HTML comment block form.

Files:

  • docs/getting-started/installation.mdx
{docs,examples}/**/*

📄 CodeRabbit inference engine (.agents/skills/rename-surfaces/SKILL.md)

Update docs and examples.

Files:

  • docs/getting-started/installation.mdx
**/*

📄 CodeRabbit inference engine (.agents/skills/validate-change/SKILL.md)

**/*: Format changed files with the language-native formatter before the final lint/test pass.
If dynamic plugin behavior changed, use maintain-dynamic-plugins and include the native SDK, worker protocol, Python SDK, docs, packaging, and Codecov surfaces in the validation plan.
If code changes alter APIs, bindings, commands, paths, packaging behavior, observability/adaptive semantics, or documented best practices, update any dependent maintainer or consumer skills in the same branch.
During iteration, prefer uv run pre-commit run --files <changed files...>.
Before review or handoff, run uv run pre-commit run --all-files.

Files:

  • docs/getting-started/installation.mdx
docs/**/*

📄 CodeRabbit inference engine (.agents/skills/validate-change/SKILL.md)

If documentation examples or commands under docs/ change, run the targeted docs checks appropriate to the change.

Files:

  • docs/getting-started/installation.mdx
{docs/**,README.md,CONTRIBUTING.md,RELEASING.md,SECURITY.md}

⚙️ CodeRabbit configuration file

{docs/**,README.md,CONTRIBUTING.md,RELEASING.md,SECURITY.md}: Review documentation for technical accuracy against the current API, command correctness, and consistency across language bindings.
Flag stale examples, missing SPDX headers where required, and instructions that no longer match CI or pre-commit behavior.

Files:

  • docs/getting-started/installation.mdx
🔇 Additional comments (1)
docs/getting-started/installation.mdx (1)

234-243: LGTM!


Walkthrough

The Hermes installation documentation now requires Hermes Agent 0.18.2 or newer, verifies the hermes CLI in a new shell, and sequences NeMo Relay integration setup after the prerequisite checks.

Changes

Hermes installation documentation

Layer / File(s) Summary
Document Hermes prerequisites and verification
docs/getting-started/installation.mdx, docs/nemo-relay-cli/hermes.mdx
Adds the Hermes Agent 0.18.2+ prerequisite, new-shell guidance, and hermes --version verification before running the NeMo Relay integration commands.

Estimated code review effort: 1 (Trivial) | ~3 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title uses a valid Conventional Commits docs type and succinctly matches the Hermes installation documentation change.
Description check ✅ Passed The description follows the required sections and includes overview, details, reviewer start, validation, and a related issue.
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.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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

@github-actions github-actions Bot added size:S PR is small Documentation documentation-related labels Jul 20, 2026
@github-actions

github-actions Bot commented Jul 20, 2026

Copy link
Copy Markdown

@willkill07 willkill07 added this to the 0.6 milestone Jul 20, 2026
@bbednarski9
bbednarski9 marked this pull request as ready for review July 20, 2026 20:47
@bbednarski9
bbednarski9 requested review from a team and lvojtku as code owners July 20, 2026 20:47

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/getting-started/installation.mdx`:
- Around line 234-237: Update the Hermes setup instructions around the existing
PATH check to add the same hermes --version verification command used in
docs/nemo-relay-cli/hermes.mdx before nemo-relay install hermes, preserving the
surrounding installation and diagnosis flow.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Enterprise

Run ID: 7f954b48-3120-4670-9b5f-0fd7bf1db2ff

📥 Commits

Reviewing files that changed from the base of the PR and between 8391f01 and c5c4be8.

📒 Files selected for processing (2)
  • docs/getting-started/installation.mdx
  • docs/nemo-relay-cli/hermes.mdx
📜 Review details
⏰ Context from checks skipped due to timeout. (2)
  • GitHub Check: Check / Run
  • GitHub Check: Preview docs
🧰 Additional context used
📓 Path-based instructions (7)
**/*.mdx

📄 CodeRabbit inference engine (.agents/skills/review-doc-style/SKILL.md)

MDX top-of-file SPDX comments must use {/* ... */} delimiters instead of HTML comment delimiters (Must-Fix)

In MDX files, top-of-file comments must use JSX comment delimiters ({/* to open and */} to close); do not use HTML comments for MDX SPDX headers

Files:

  • docs/getting-started/installation.mdx
  • docs/nemo-relay-cli/hermes.mdx
**/*.{md,mdx}

📄 CodeRabbit inference engine (AGENTS.md)

Update README.md, fern/, package READMEs, and binding-support notes when public behavior, package names, examples, or supported bindings change.

**/*.{md,mdx}: Prefer the documented public API, not internal shortcuts
Keep package names, repo references, and build commands current
Keep release-process and release-notes guidance in repo-maintainer docs such as RELEASING.md, not as user-facing docs pages or CHANGELOG.md
Keep stable user-facing wrappers at scripts/ root in docs and examples; only point at namespaced helper paths when documenting internal maintenance work
When detailed dynamic plugin guides exist, keep Rust native plugin examples, Python worker plugin examples, and grpc-v1 protocol details on separate pages

If links in documentation change, run just docs-linkcheck.

Files:

  • docs/getting-started/installation.mdx
  • docs/nemo-relay-cli/hermes.mdx
**/*.{md,markdown,mdx}

📄 CodeRabbit inference engine (CONTRIBUTING.md)

Add the SPDX license header to all Markdown/MDX documentation files using the HTML comment block form.

Files:

  • docs/getting-started/installation.mdx
  • docs/nemo-relay-cli/hermes.mdx
{docs,examples}/**/*

📄 CodeRabbit inference engine (.agents/skills/rename-surfaces/SKILL.md)

Update docs and examples.

Files:

  • docs/getting-started/installation.mdx
  • docs/nemo-relay-cli/hermes.mdx
**/*

📄 CodeRabbit inference engine (.agents/skills/validate-change/SKILL.md)

**/*: Format changed files with the language-native formatter before the final lint/test pass.
If dynamic plugin behavior changed, use maintain-dynamic-plugins and include the native SDK, worker protocol, Python SDK, docs, packaging, and Codecov surfaces in the validation plan.
If code changes alter APIs, bindings, commands, paths, packaging behavior, observability/adaptive semantics, or documented best practices, update any dependent maintainer or consumer skills in the same branch.
During iteration, prefer uv run pre-commit run --files <changed files...>.
Before review or handoff, run uv run pre-commit run --all-files.

Files:

  • docs/getting-started/installation.mdx
  • docs/nemo-relay-cli/hermes.mdx
docs/**/*

📄 CodeRabbit inference engine (.agents/skills/validate-change/SKILL.md)

If documentation examples or commands under docs/ change, run the targeted docs checks appropriate to the change.

Files:

  • docs/getting-started/installation.mdx
  • docs/nemo-relay-cli/hermes.mdx
{docs/**,README.md,CONTRIBUTING.md,RELEASING.md,SECURITY.md}

⚙️ CodeRabbit configuration file

{docs/**,README.md,CONTRIBUTING.md,RELEASING.md,SECURITY.md}: Review documentation for technical accuracy against the current API, command correctness, and consistency across language bindings.
Flag stale examples, missing SPDX headers where required, and instructions that no longer match CI or pre-commit behavior.

Files:

  • docs/getting-started/installation.mdx
  • docs/nemo-relay-cli/hermes.mdx
🔇 Additional comments (1)
docs/nemo-relay-cli/hermes.mdx (1)

27-41: LGTM!

Comment thread docs/getting-started/installation.mdx Outdated
Signed-off-by: Bryan Bednarski <bbednarski@nvidia.com>
@bbednarski9

Copy link
Copy Markdown
Contributor Author

/merge

@rapids-bot
rapids-bot Bot merged commit 7766342 into NVIDIA:release/0.6 Jul 20, 2026
27 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation documentation-related size:S PR is small

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants