⚡ 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:
- Run
hermes config get web.backend. - Run
hermes config get web.search_backend. - 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.
| Provider | Searches go to | Good to know |
|---|---|---|
| SearXNG | Your own server | Free; search only |
| DuckDuckGo | DuckDuckGo | No key; search only |
| Brave | Brave | 2,000 free a month; search only |
| Firecrawl, Exa, Tavily | That company | Free tiers; search and reading |
| Nous Gateway | Nous Research | Nous Portal subscription |
Then set it in Hermes Desktop:
- Click Capabilities in the sidebar.
- Open the Tools tab.
- Click Web Search.
- Pick a provider and add its key if it asks for one.
- Wait for the message that the provider “is now active”.
From the terminal:
- Run
hermes tools. - Choose the web search provider.
- 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
- Run
hermes config get web.keyless_fallback. It should sayfalse. - Run
hermes config get web.backendandhermes config get web.search_backend. One of them should name the provider you picked in step 2. - 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.
The Tested Weekly
One email a week with the guides we tested, sources linked. No spam.