Skip to content
Guide

Web search in Aldwin

Pick a search provider for Aldwin, from self-hosted SearXNG to a hosted API key.

On this page

Aldwin's web_search tool can use one of seven search providers. Every provider gives the same kind of answer: a numbered list of results with a title, a link, and a short snippet. You only need one.

Without any of them, Aldwin still works. It can open pages you name with web_fetch, and use every other tool.

Providers#

ProviderCostConnect withGuide
SearXNGFree, runs on your machine/search, or found automatically on port 8080Set up SearXNG
TavilyFree monthly credits, then paid/search or aldwin setupSet up Tavily
BravePaid plan/searchSet up Brave
ExaPaid/searchSet up Exa
PerplexityPaid/searchSet up Perplexity
ParallelPaid/searchSet up Parallel
FirecrawlPaid plan with credits/searchSet up Firecrawl

Connect a provider#

In the web app, open Settings and choose Search. Select Connect on a provider and paste its key, or for SearXNG its address. Use this one picks which provider Aldwin uses. You can also switch from the search picker in the message box. See Web app settings.

In the terminal, type /search, pick a provider with the arrow keys, and paste its key. Aldwin checks the key with the provider before saving it, and tells you why if it doesn't work. Pick a connected provider to use it, update its key, or disconnect it. Each guide above walks through it.

Keys are saved in ~/.aldwin/secrets.yaml. If you prefer environment variables, each guide lists the name (for example BRAVE_API_KEY); an environment variable wins over a saved key.

How Aldwin picks one#

By default search.provider is auto. Aldwin uses the first provider that is set up, in this order:

  1. Tavily
  2. SearXNG
  3. Brave
  4. Exa
  5. Perplexity
  6. Parallel
  7. Firecrawl

To use a specific provider whatever else is connected, choose Use this one in the web app's Search settings, or pick it in /search and choose Use for search, or type /search exa. Aldwin saves the choice in ~/.aldwin/config.yaml. Pick Automatic (or type /search auto) to go back.

/search status prints a plain text summary of every provider.

Where your searches go#

  • SearXNG: to your own instance, which then asks public search engines.
  • Hosted providers: to that company's servers over the internet, under its own terms.

Either way, pages Aldwin opens afterwards with web_fetch are fetched from your machine. When you connect a hosted provider, Aldwin sends the key to it once to check it. Aldwin never puts your key in an error message. More in Privacy.

Was this page helpful?