hermes - 💡(How to fix) Fix Brew bottle missing plugin.yaml manifests for web search providers [2 pull requests]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Root Cause

Root cause The brew bottle includes directories like plugins/web/firecrawl/, tavily/, exa/, parallel/, ddgs/, searxng/ but WITHOUT their plugin.yaml manifests. Without these files, PluginManager._scan_directory() never discovers them, register() is never called, and no WebSearchProvider gets registered.

Fix Action

Fixed

Code Example

from agent.web_search_registry import list_providers
print(list_providers())  # → []

---

from hermes_cli.plugins import discover_plugins
discover_plugins(force=True)
from agent.web_search_registry import list_providers
print(list_providers())  # → ["ddgs", "exa", "firecrawl", ...]

---

name: web-firecrawl
version: 1.0.0
description: "Firecrawl web search + content extraction. Supports direct API and Nous-hosted tool-gateway routing for subscribers."
author: NousResearch
kind: backend
provides_web_providers:
  - firecrawl
RAW_BUFFERClick to expand / collapse

After brew install hermes-agent on Linux, web_search fails with "No web search provider configured" despite valid Nous subscription and managed tools being active.

Root cause The brew bottle includes directories like plugins/web/firecrawl/, tavily/, exa/, parallel/, ddgs/, searxng/ but WITHOUT their plugin.yaml manifests. Without these files, PluginManager._scan_directory() never discovers them, register() is never called, and no WebSearchProvider gets registered.

from agent.web_search_registry import list_providers
print(list_providers())  # → []

After creating plugin.yaml (content from GitHub raw) and discover_plugins(force=True):

from hermes_cli.plugins import discover_plugins
discover_plugins(force=True)
from agent.web_search_registry import list_providers
print(list_providers())  # → ["ddgs", "exa", "firecrawl", ...]

To reproduce

  1. brew install hermes-agent on Linux
  2. Setup Nous auth, verify managed_nous_tools_enabled() → True
  3. Try web_search → "No web search provider configured"
  4. ls $(python3 -c "import hermes_cli; print(hermes_cli.__file__.rstrip(chr(95)*2+chr(105)+chr(110)+chr(105)+chr(116)+chr(95)*2+chr(46)+chr(112)+chr(121))") )plugins/web/firecrawl/plugin.yaml → no such file

Environment

  • Hermes: 2026.5.16 (brew bottle)
  • OS: Linux x86_64 (Ubuntu 24.04)
  • Provider: nous (managed tools active)

Example plugin.yaml for firecrawl:

name: web-firecrawl
version: 1.0.0
description: "Firecrawl web search + content extraction. Supports direct API and Nous-hosted tool-gateway routing for subscribers."
author: NousResearch
kind: backend
provides_web_providers:
  - firecrawl

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

hermes - 💡(How to fix) Fix Brew bottle missing plugin.yaml manifests for web search providers [2 pull requests]