Hermes Agent Integration

Nginjen ships with a ready-to-use Hermes Agent plugin for web search and content extraction.

Install the Plugin

cp -r integrations/hermes ~/.hermes/plugins/web/nginjen

Configure Hermes

In your Hermes .env:

NGINJEN_URL=http://127.0.0.1:9090

In config.yaml:

web:
  extract_backend: "nginjen"
  search_backend: "nginjen"

How It Works

When the plugin is active:

• web_extract calls Nginjen's /scrape endpoint to fetch and extract page content
• web_search calls Nginjen's /search endpoint to query the built-in search engine

Both go through a real Chromium browser with full stealth injection, which means they handle JavaScript-rendered pages and avoid detection better than simple HTTP scrapers.

API Key

If your Nginjen server has api_key set, add it to your .env:

NGINJEN_URL=http://127.0.0.1:9090
NGINJEN_API_KEY=your-secret-key

SearXNG with Hermes

For maximum search coverage, you can chain Nginjen with a self-hosted SearXNG instance:

# Start SearXNG
cd integrations/hermes/searxng-setup
echo "SEARXNG_SECRET=$(openssl rand -hex 32)" > .env
docker compose up -d

# Nginjen config
[search]
backend = "searxng"
searxng_url = "http://localhost:8080"

This gives Hermes access to dozens of search engines through a single Nginjen endpoint.

Full Setup Guide

See integrations/hermes/SETUP.md for the complete walkthrough.