Setup modes

This project is simple in one sense and a little messy in another.

The package itself is focused. The broader world around search and research workflows is not.

Basic use

The simplest path is just installing the package in Pi and using the tools as they exist today.

If all you want is the current package behavior, this is the setup that matters.

If you want to tune how tool output shows up in the transcript, see Presentation and settings.

Some of the open issues point toward hosted search providers.

That is where the project is headed, not something you should assume is fully wired into the default install today.

If you are evaluating the package early, check the issue tracker before assuming every provider-backed path is already there.

If you already run SearXNG or Firecrawl, pi-web-agent can connect to them through backend config.

See Self-hosted backends for the config shape, verification steps, and troubleshooting notes.