hermes-web-tools

Diagnose and fix Hermes web_search failures by installing ddgs into the Hermes venv.

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/TylerSimons1127/vibe --skill hermes-web-tools-tylersimons1127
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-web-tools
Source: https://github.com/TylerSimons1127/vibe/tree/main/skills/devops/hermes-web-tools
Command: npx skills add https://github.com/TylerSimons1127/vibe --skill hermes-web-tools-tylersimons1127

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ddgs, and includes references (resource) components.

What problem does it solve? Hermes web_search fails with a misleading Firecrawl "no usable paid credits" error even though search is configured to use the free DuckDuckGo backend, because the ddgs Python package is missing from the Hermes virtual environment. ## Core Features & Use Cases - Root Cause Diagnosis: Explains why the Firecrawl credits error appears when the real issue is a missing ddgs package in the Hermes venv. - Venv Bootstrap Fix: Provides exact commands to bootstrap pip via ensurepip and install ddgs into the Hermes venv, which normally has no pip and is misdetected by uv. - Use Case: On a fresh Windows machine, your Hermes agent's web_search returns a Firecrawl credits error. Follow the reference guide to run ensurepip and pip install ddgs against the venv's python.exe, then verify with an import check so search works with zero API keys or credits. ## Quick Start Fix my Hermes web_search that keeps failing with a Firecrawl no-credits error by installing ddgs into the Hermes venv.

Frequently Asked Questions about hermes-web-tools

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Hermes web_search not configured error?▼

The web_search not configured error is usually caused by a missing ddgs package in the Hermes venv, not missing Firecrawl credits. Bootstrap pip with ensurepip, then run pip install ddgs using the venv's python.exe to restore free DuckDuckGo search.

How to install ddgs into the Hermes venv on Windows?▼

Run the venv python.exe with -m ensurepip --upgrade to bootstrap pip, then -m pip install ddgs, and verify with -c "import ddgs". Use the full path ending in Scripts/python.exe and do not strip the .exe extension.

Why does uv pip install fail on the Hermes venv?▼

uv pip install --python fails because uv misdetects the Hermes venv and reports no virtual environment found. Use the venv's python.exe with -m pip directly after bootstrapping pip via ensurepip instead.

Does web_search need a Firecrawl API key?▼

No, web_search uses the ddgs DuckDuckGo scraper backend which requires no API key or credits. Only web_extract is Firecrawl-backed and needs paid credits unless you change extract_backend to ddgs in config.yaml.

Can I make Hermes web_extract free without Firecrawl credits?▼

Yes, set extract_backend to ddgs in the Hermes profile config.yaml so extraction uses the free DuckDuckGo-backed fetch and summarize path. Otherwise web_extract keeps failing without Firecrawl credits even after the ddgs search fix.