Hermes Crawl4SearXNG

What Hermes Crawl4SearXNG does

Hermes Crawl4SearXNG keeps the tools Hermes models already know and swaps what runs behind them. Search goes to SearXNG using Hermes's own bundled provider, which only needs SEARXNG_URL set. Extraction goes to Crawl4AI, which is this plugin's contribution because no bundled Hermes provider wraps it. The plugin registers a real WebSearchProvider through ctx.register_web_search_provider, so it adds no custom tool names and does not collide with the built-in web toolset.

Two extras ship with it. The save_finding tool writes a cited research note to ~/.hermes/knowledge/ as markdown, with optional sources appended as a list. The deep-research skill follows a search, extract, synthesize, cite and optionally save workflow. The install.sh script starts Crawl4AI and SearXNG in Docker, generates secrets on first run, syncs the URLs and token into the Hermes .env, enables the plugin, sets web.extract_backend to crawl4ai and restarts the gateway. It is safe to re-run, and uninstall.sh keeps data unless --purge is passed.

Key features

• Self-hosted SearXNG search and Crawl4AI extraction behind Hermes web_search and web_extract
• Registers a WebSearchProvider with no custom tool names
• save_finding tool for cited research notes in ~/.hermes/knowledge/
• Bundled deep-research skill for search, extract, synthesize and cite
• install.sh that provisions Docker services, generates secrets and wires Hermes
• Bundled and symlink install modes, plus uninstall.sh with an optional --purge

When to use it

• Giving a Hermes agent web research without a paid search API
• Extracting LLM-friendly page content from sites through your own Crawl4AI instance
• Saving cited findings from research sessions into a local knowledge folder

Who it is for: Hermes Agent users who want web search and page extraction running on their own infrastructure.

How it fits with Hermes Agent

Built as a Hermes Agent plugin that plugs into the native web search and extract tools and the Hermes plugin installer.

How to install Hermes Crawl4SearXNG

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

git clone https://github.com/GoSlowPoke168/hermes-crawl4searxng.git
cd hermes-crawl4searxng
./install.sh

Requirements: Docker with Compose v2, openssl, and the Hermes Agent CLI on PATH

FAQ