Skip to content

docs: add hermes-agent plugin - #2863

Open
JanHranicky wants to merge 4 commits into
masterfrom
docs/hermes-agent
Open

docs: add hermes-agent plugin#2863
JanHranicky wants to merge 4 commits into
masterfrom
docs/hermes-agent

Conversation

@JanHranicky

Copy link
Copy Markdown
Contributor

@github-actions github-actions Bot added the t-integrations Issues with this label are in the ownership of the integrations team. label Aug 11, 2026
@apify-service-account

apify-service-account commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

✅ Preview for this PR (commit ca84536f) is ready at https://pr-2863.preview.docs.apify.com (see action run).

@JanHranicky JanHranicky added the adhoc Ad-hoc unplanned task added during the sprint. label Aug 11, 2026

@marcel-rbro marcel-rbro left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

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';

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

The underscores are escaped here but not in any other integration page.

Suggested change
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.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

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`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

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:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This command enables the plugin rather than confirming it, and the style guide asks for version 0.18.1 in prose.

Suggested change
- _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

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

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."

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Product names take no article, matching the OpenClaw and Manus cards.

Suggested change
desc="Discover and run any Apify Actor in the Hermes Agent."
desc="Discover and run Apify Actors from Hermes Agent."

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

adhoc Ad-hoc unplanned task added during the sprint. t-integrations Issues with this label are in the ownership of the integrations team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants