docs: add hermes-agent plugin - #2863
Conversation
JanHranicky
commented
Aug 11, 2026
- adding documentation for https://github.com/apify/apify-hermes-agent-plugin integration
|
✅ Preview for this PR (commit |
marcel-rbro
left a comment
There was a problem hiding this comment.
Checked the page against the plugin source and PyPI - both packages are published and the technical details match.
| toc_min_heading_level: 2 | ||
| --- | ||
|
|
||
| import ThirdPartyDisclaimer from '@site/sources/\_partials/\_third-party-integration.mdx'; |
There was a problem hiding this comment.
The underscores are escaped here but not in any other integration page.
| import ThirdPartyDisclaimer from '@site/sources/\_partials/\_third-party-integration.mdx'; | |
| import ThirdPartyDisclaimer from '@site/sources/_partials/_third-party-integration.mdx'; |
| - _An Apify account_ - If you don't have one, [sign up here](https://console.apify.com/sign-up). | ||
| - _Apify API token_ - Get your token from the **API & Integrations** section in [Apify Console](https://console.apify.com/settings/integrations). | ||
| - _Hermes Agent_ - Install the CLI from the [official documentation](https://hermes-agent.nousresearch.com/docs). | ||
| - _Python 3.11+_ - Required to install the plugin. |
There was a problem hiding this comment.
hermes-agent requires >=3.11,<3.14, so should this say Python 3.11 - 3.13?
|
|
||
| :::note Dataset results are untrusted content | ||
|
|
||
| `apify_collect` wraps returned dataset items between `<<<EXTERNAL_UNTRUSTED_CONTENT>>>` markers, since scraped data comes from external websites and Actors, not from you or Hermes Agent. Results are also capped at 50,000 characters per run - if `may_have_more` is `true` in the response, re-call `apify_collect` with a higher `limit`. |
There was a problem hiding this comment.
The code sets may_have_more when the item count hits limit (default 100), but the 50,000-character cap is a separate cut that a higher limit cannot undo - should these be two separate sentences?
|
|
||
| ### Plugin or tool not available | ||
|
|
||
| - _Check plugin enablement_ - Run `hermes plugins enable apify` to confirm the plugin is enabled. If that fails with `Plugin 'apify' is not installed or bundled.`, your Hermes Agent predates `0.18.1`, when entry-point plugin discovery was fixed upstream - update with `pip install --upgrade hermes-agent`. If you can't upgrade, add `apify` under `plugins.enabled` in `~/.hermes/config.yaml` manually instead: |
There was a problem hiding this comment.
This command enables the plugin rather than confirming it, and the style guide asks for version 0.18.1 in prose.
| - _Check plugin enablement_ - Run `hermes plugins enable apify` to confirm the plugin is enabled. If that fails with `Plugin 'apify' is not installed or bundled.`, your Hermes Agent predates `0.18.1`, when entry-point plugin discovery was fixed upstream - update with `pip install --upgrade hermes-agent`. If you can't upgrade, add `apify` under `plugins.enabled` in `~/.hermes/config.yaml` manually instead: | |
| - _Check plugin enablement_ - Re-run `hermes plugins enable apify`. If it fails with `Plugin 'apify' is not installed or bundled.`, your Hermes Agent predates version 0.18.1, when entry-point plugin discovery was fixed upstream - update with `pip install --upgrade hermes-agent`. If you can't upgrade, add `apify` under `plugins.enabled` in `~/.hermes/config.yaml` manually instead: |
| title: Hermes Agent integration | ||
| sidebar_label: Hermes Agent | ||
| description: Learn how to integrate Apify with Hermes Agent to give your AI agent access to thousands of pre-built AI tools, called Actors, for scraping and automation. | ||
| slug: /integrations/hermes-agent |
There was a problem hiding this comment.
Other pages here match their slug, so should this file be hermes-agent.md?
| /> | ||
| <Card | ||
| title="Hermes Agent" | ||
| desc="Discover and run any Apify Actor in the Hermes Agent." |
There was a problem hiding this comment.
Product names take no article, matching the OpenClaw and Manus cards.
| desc="Discover and run any Apify Actor in the Hermes Agent." | |
| desc="Discover and run Apify Actors from Hermes Agent." |