Skip to main content
Built-in web backend Keenable ships inside Hermes Agent as a bundled web backend. It serves both of Hermes’s web tools, web_search and web_extract, with no plugin to install and no account to create. → View the provider on GitHub A fresh install with no web credentials already reaches Keenable some of the time: Hermes rotates keyless requests across the public free tiers of Exa, Parallel, Firecrawl and Keenable, and moves to the next vendor when one is rate-limited. With a Nous Portal sign-in, including the desktop app’s free guest tier, web_search goes to Nous’s managed search instead. If you select Keenable, every call goes to Keenable, so results stay consistent from one run to the next, with or without a key.

Install

Install Hermes Agent

On Linux, macOS, WSL2 or Termux:
On native Windows, in PowerShell:
You don’t install anything Keenable-specific: the backend is part of Hermes itself.

Select Keenable

Run hermes tools and pick Keenable · Free (keyless) for web search and extract, or set it directly:
A backend you select always wins over the rotation and over the managed search. To use Keenable for only one of the two tools, set web.search_backend or web.extract_backend instead of web.backend.

Add an API key (optional)

Create a key in the console (see Authentication), then save it in Hermes:
Hermes keeps the key in ~/.hermes/.env and sends it to Keenable’s authenticated endpoint. If no backend was ever selected, the key alone makes Hermes pick Keenable, unless a Tavily, Perplexity, Exa or Parallel key is set too. In hermes tools, Keenable · Paid (API key) pins the keyed path. If the key is missing, calls fail with an error instead of dropping to the free tier. Free (keyless) stays keyless even after you add a key.

Check it

These commands check the web tools and show the selected backend:
hermes doctor reports whether web_search and web_extract are ready. Then start hermes and ask something that needs the web.
Set KEENABLE_API_KEY to remove the hourly request cap. If you don’t set a key, calls run on the shared keyless tier, which allows 1,000 requests per hour per IP address. See Rate limits.

The hermes-keenable-web plugin

Before Keenable was bundled, this page pointed to a standalone PyPI plugin, hermes-keenable-web. The built-in backend replaces it. If you installed the plugin, uninstall it from the environment Hermes runs in (pip uninstall hermes-keenable-web), or delete ~/.hermes/plugins/web/keenable/ if you copied it there by hand: it registers under the same name, keenable, and takes the built-in backend’s place.

web-search-plus (Hermes)

Keenable as a web-search and extract provider in the web-search-plus community plugin for the Hermes agent.

ketch

Use Keenable as the built-in search backend in ketch, the agent CLI written in Go.

GPT Researcher

Give GPT Researcher web search with no API key through gpt-researcher-keenable, a retriever plugin.

Integrations

Connect Keenable web search to your agent stack: LangChain, LlamaIndex, Haystack, MCP and more.