Metadata-Version: 2.4
Name: apify-hermes-agent-plugin
Version: 0.1.1
Summary: Hermes Agent plugin for Apify, the world's largest marketplace for AI tools — discover, run, and collect results from Actors, all from natural language
Author-email: "Apify Technologies s.r.o." <support@apify.com>
License: MIT
Project-URL: Homepage, https://github.com/apify/apify-hermes-agent-plugin
Project-URL: Source Code, https://github.com/apify/apify-hermes-agent-plugin
Project-URL: Issue Tracker, https://github.com/apify/apify-hermes-agent-plugin/issues
Project-URL: Changelog, https://github.com/apify/apify-hermes-agent-plugin/blob/main/CHANGELOG.md
Project-URL: Hermes Agent, https://hermes-agent.nousresearch.com
Keywords: apify,hermes,hermes-agent,actor,plugin,ai-tools,automation
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: hermes-agent>=0.15.1
Requires-Dist: apify-client<4,>=3.0.1
Provides-Extra: dev
Requires-Dist: pytest==9.0.2; extra == "dev"
Requires-Dist: pytest-asyncio==1.3.0; extra == "dev"
Requires-Dist: ruff<0.17,>=0.15.20; extra == "dev"
Requires-Dist: ty<0.1,>=0.0.65; extra == "dev"
Dynamic: license-file

# apify-hermes-agent-plugin

Hermes Agent plugin for [Apify](https://apify.com), the world's largest marketplace for AI tools - discover
Actors in Apify Store, start runs, and collect structured results, all from natural language, via
[Hermes Agent](https://hermes-agent.nousresearch.com).

## Install

    pip install apify-hermes-agent-plugin
    hermes plugins enable apify

Then run:

    hermes apify-setup

This prompts for your `APIFY_API_TOKEN` (get one at https://apify.com/account/integrations),
saves it, and enables the Apify Actors toolset for the CLI. Pass `--token <token>` to skip the
prompt.

### Troubleshooting: `hermes plugins enable apify` fails

If that command prints `Plugin 'apify' is not installed or bundled.`, your installed
`hermes-agent` predates `0.18.1`, when entry-point plugin discovery was fixed upstream.
Check your version and upgrade first:

    hermes --version
    pip install --upgrade hermes-agent

If you can't upgrade, enable the plugin manually instead: open `~/.hermes/config.yaml` and
add `apify` to the `plugins.enabled` list:

    plugins:
      enabled:
        - apify

Then run `hermes apify-setup` as above - it still takes care of enabling the toolset for you.

## Tools

- `apify_discover` - search Apify Store by keyword, or fetch an Actor's input schema + README by `actor_id`.
- `apify_start` - fire-and-forget batch Actor starts (up to 10 per call).
- `apify_collect` - poll run statuses and return completed dataset results.

## Development

    pip install -e ".[dev]"
    pytest
