🌱 Welcome to Factnetize — honest, well-researched articles on tech, health and AI. Get the weekly →
Agentic AI

Hermes web search: where your searches go, and how to choose

A fresh Hermes install searches the web without any key by rotating your queries over four free services. Here is how to check what your Hermes uses, pick one provider yourself, and turn the rotation off.

Laptop on a dark desk with four thin beams of amber light fanning out from it, a brass lamp and a padlock beside it
âś“ Verified against Hermes Agent v0.23.2 (November 18, 2026). Every command, setting and docs link in this article still exists in Hermes. We re-check all Hermes articles every week.

⚡ Key takeaways

  • Hermes web search works on a fresh install without any key, because it rotates your searches across four free services: Exa, Parallel, Firecrawl and Keenable.
  • That is handy, but you never chose those services. Pick one search provider yourself under Capabilities, Tools, Web Search.
  • One setting, web.keyless_fallback: false, stops the silent rotation, including the one-off “rescue” when your own provider fails.
  • A privacy-respecting option is SearXNG on your own PC: your own server asks the search engines for you.

Ask Hermes to look something up and it just works, even if you never set up a search service. That convenience has a price you do not see: your search queries leave your PC and go to whichever free service is next in line. This guide shows where Hermes web search sends your queries by default, how to check what your own Hermes does, and how to pick one provider and switch the silent rotation off.

Where Hermes web search sends your queries

Hermes has two web tools: web_search finds pages, and web_extract reads them. Both are set through one backend choice. According to the Hermes web search docs, a new install with no search provider and no search keys rotates every call round-robin across the free public tiers of Exa, Parallel, Firecrawl and Keenable.

Two settings in config.yaml control this, and both are on by default:

web:
  keyless_fallback: true   # nothing chosen: rotate over the free ring
  keyless_rescue: true     # your provider fails: retry that one call on the free ring

So even after you pick your own provider, a failed call still goes to the free ring. The Hermes source shows that the rescue switches itself off when keyless_fallback is false, so one setting stops both.

Step 1: check what your Hermes uses

The quickest way is to ask Hermes itself. In a chat, type:

Which web search backend do you use, and what are web.keyless_fallback and web.keyless_rescue set to?

From a terminal:

  1. Run hermes config get web.backend.
  2. Run hermes config get web.search_backend.
  3. Run hermes config get web.keyless_fallback.

Both backends empty, no search key or SearXNG address set, and true: you are on the free rotation.

Step 2: pick one search provider

Table 1 lists the options from the docs that matter most for privacy. Want the least setup? Take Firecrawl or Exa with your own free key: both search and read pages. Want your searches to stay with you? Run SearXNG with Docker, as the docs describe.

ProviderSearches go toGood to know
SearXNGYour own serverFree; search only
DuckDuckGoDuckDuckGoNo key; search only
BraveBrave2,000 free a month; search only
Firecrawl, Exa, TavilyThat companyFree tiers; search and reading
Nous GatewayNous ResearchNous Portal subscription
Table 1 · Hermes web search providers, by where your queries end up

Then set it in Hermes Desktop:

  1. Click Capabilities in the sidebar.
  2. Open the Tools tab.
  3. Click Web Search.
  4. Pick a provider and add its key if it asks for one.
  5. Wait for the message that the provider “is now active”.

From the terminal:

  1. Run hermes tools.
  2. Choose the web search provider.
  3. For Exa, Parallel or Keenable, pick the Paid (API key) row, not Free (keyless), if you want your own account instead of the anonymous endpoint.

Search-only providers cannot read pages. Pair them with a second provider for web_extract; the docs give SearXNG for search plus Firecrawl for reading as the example.

Step 3: turn off the silent rotation

Do this even after picking a provider, or failed calls still go to the free ring. There is no switch for it in Desktop, so tell Hermes in a chat:

Set web.keyless_fallback to false in my config.

Or run it yourself in a terminal:

hermes config set web.keyless_fallback false

Check that it works

  1. Run hermes config get web.keyless_fallback. It should say false.
  2. Run hermes config get web.backend and hermes config get web.search_backend. One of them should name the provider you picked in step 2.
  3. Ask Hermes to search for something simple. A normal answer means your own provider handled it.

From my own use

I never touched these settings. My time went into getting web access right the hard way: Scrapling for sites that block bots, and the Browser Use cloud service for pages that need a real browser.

Troubleshooting

  • Web search stopped working after step 3. You turned off the free ring but never picked a provider. Do step 2, or set the setting back to true.
  • Searches work, but reading a page fails. Your provider is search-only, such as SearXNG, DDGS or Brave. Add a second provider for page reading.
  • A site blocks Hermes. A different search provider will not fix that. Scrapling for Hermes is built for sites that fight back.

Frequently asked questions

What is the best Hermes web search backend?

For privacy, a self-hosted SearXNG for search, plus one provider you trust for reading pages, because SearXNG cannot read pages. For the least setup, a single provider with your own key, such as Firecrawl or Exa.

What’s next

Search is only one way your agent sends data out. The model sees everything too: zero data retention with Command Code shows how to stop a model provider from keeping your prompts. New to Hermes tools in general? Start with Hermes tools 101.

This article is part of the Agentic AI series.

John Lock
Written by

John Lock

The Tested Weekly

One email a week with the guides we tested, sources linked. No spam.

Leave a comment

Your email address will not be published. Required fields are marked *

Weekly · No spam

The Tested Weekly

One email a week with the guides we tested, sources linked.