Web search in Aldwin
Pick a search provider for Aldwin, from self-hosted SearXNG to a hosted API key.
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#
| Provider | Cost | Connect with | Guide |
|---|---|---|---|
| SearXNG | Free, runs on your machine | /search, or found automatically on port 8080 | Set up SearXNG |
| Tavily | Free monthly credits, then paid | /search or aldwin setup | Set up Tavily |
| Brave | Paid plan | /search | Set up Brave |
| Exa | Paid | /search | Set up Exa |
| Perplexity | Paid | /search | Set up Perplexity |
| Parallel | Paid | /search | Set up Parallel |
| Firecrawl | Paid plan with credits | /search | Set 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:
- Tavily
- SearXNG
- Brave
- Exa
- Perplexity
- Parallel
- 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.