Skip to content

Aldwin 0.0.5 - web search your way

Connect one of seven search providers from inside Aldwin, including a free one you run yourself. No config files.

Until now, Aldwin could search the web with exactly one service, Tavily. If you didn't have a Tavily key, or didn't want one, Aldwin couldn't search at all.

0.0.5 changes that. Aldwin can now search with seven providers, and one of them is free and runs on your own computer. You set it up from inside Aldwin, in about a minute, without opening a single file.

Pick from seven providers#

ProviderGood for
SearXNGFree and private. It runs on your computer and asks the big search engines for you.
TavilySearch built for AI assistants, with free monthly credits to start.
BraveBrave's own independent web index.
ExaFinding pages by meaning, with the most relevant passages from each page.
PerplexityFresh results from Perplexity's search index.
ParallelSearch designed for AI agents, with longer extracts from each page.
FirecrawlSearch from the people behind the Firecrawl web scraper.

You only need one. Every provider gives Aldwin the same thing: a list of results with a title, a link and a short snippet. Your prompts and habits don't change when you switch.

Connect one in a minute#

Type /search. You see every provider, grouped into the ones you've connected and the ones you haven't:

Web search · not set up   ↑↓ move · Enter choose · Esc back
 
  Not connected
❯ Tavily               key check can take up to 20 seconds
  SearXNG
  Brave                key check uses one Brave query
  Exa
  Perplexity
  Parallel
  Firecrawl
  Automatic            use the first connected

Move to a provider with the arrow keys and press Enter. Aldwin shows where to get a key and links to a step-by-step guide. Paste the key (it stays hidden) and press Enter.

Aldwin then checks the key with the provider before saving anything. If it works, you see:

✓ Exa connected · now used for search

If it doesn't, Aldwin tells you why in plain words, and asks again. The key might be wrong, the account might be out of credits, or the provider might be busy. Nothing is saved until a key passes.

The check doesn't cost you anything for most providers: Aldwin asks the provider's free account page, not its paid search. Brave has no free check, so its check uses one Brave search, and the menu says so before you start.

Switch, update or disconnect#

Run /search again any time. Pick a connected provider and you can:

  • Use for search, to make it the one Aldwin uses
  • Update key, to paste a new key (checked the same way)
  • Disconnect, to remove its saved key

Changes take effect on the next search. There's nothing to restart.

If you'd rather not choose, pick Automatic. Aldwin then uses the first provider you've connected, in this order: Tavily, SearXNG, Brave, Exa, Perplexity, Parallel, Firecrawl. The status line at the bottom of the screen always shows which one is in use.

You can also type a provider's name to jump straight to it: /search exa uses Exa if it's connected, or opens its key prompt if not. /search status prints a short summary of all seven.

Free search on your own computer#

If you'd rather not pay for search or share your queries with a search company, run SearXNG. It's a free, open-source search engine you run yourself, usually in Docker. It asks Google, Bing, DuckDuckGo and others on your behalf, so they see SearXNG instead of you.

Aldwin finds a SearXNG on your computer by itself when it's running on the usual port, 8080. If yours lives somewhere else, pick SearXNG in /search and type its address.

Manage your model keys too#

The same idea now applies to model keys. In /model, a new Manage keys… option lets you update or remove a saved key for OpenAI, Anthropic, Gemini, OpenRouter or DeepSeek, without editing any files. Aldwin won't remove the key for the model you're using right now, so you can't break the conversation you're in.

We also tightened the OpenRouter key check. A wrong OpenRouter key used to slip through; now it's caught before it's saved.

Copy an answer with /copy#

Selecting text in a terminal picks up stray spaces and line breaks. Type /copy and Aldwin puts its last answer on your clipboard exactly as it wrote it, as clean markdown. /copy code copies just the last code block, ready to paste.

A guide for every provider#

The docs now have a step-by-step guide for each search provider, and for each model provider too. Each guide covers how to get a key, how to connect it, what it costs, where your data goes, and what to do if something goes wrong. Start with Web search in Aldwin or Model providers in Aldwin.

Where your searches go#

  • With SearXNG, your searches go to your own computer, which then asks public search engines.
  • With a hosted provider, your searches go to that company over the internet, under its own terms.

Either way, pages Aldwin opens afterwards are fetched from your computer. When you connect a provider, Aldwin sends the key to it once to check it, keeps it in a file only your account can read, and never shows it in an error message.

Upgrade#

uv tool upgrade aldwin

Everything you had stays: conversations, notes, memory, connectors, persona, settings and keys. If you already use Tavily, it keeps working with no change.

New to Aldwin? Start with Install.

Try it#

Run aldwin, type /search, and connect one provider. Then ask something that needs today's web, like "What's the latest Python release, and what changed?" You'll see Aldwin search, then answer with links you can check.

Full release notes: changelog v0.0.5.