pi-hybrid-web-search

Hybrid provider-native web search with client-side fallback for Pi.

Packages

Package details

extension

Install pi-hybrid-web-search from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:pi-hybrid-web-search
Package
pi-hybrid-web-search
Version
1.0.1
Published
Aug 6, 2026
Downloads
311/mo · 16/wk
Author
whfzgyx
License
MIT
Types
extension
Size
14.9 KB
Dependencies
2 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/web-search/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Hybrid Web Search for Pi

One web_search tool with model-aware routing:

  1. Gemini, Claude, and GPT models use their current provider's native web-search service.
  2. Models without native search, including Ollama/OpenAI Chat Completions models, use client search.
  3. Native errors or ungrounded native responses automatically fall back to client search.
  4. Client search tries the active provider, configured keyed providers, then keyless Exa Free and Bing. A configured SearXNG endpoint also participates.

The current conversation model receives the tool result and writes the final answer. Client fallback never switches the conversation to another LLM.

Install

Remove other packages that register the same web_search tool, then install this package:

pi remove npm:pi-web-search
pi install npm:pi-hybrid-web-search

Run /reload in an existing Pi session, or start a new session.

Tools

  • web_search: hybrid native/client search.
  • web_fetch: client-side page extraction from @bytetrue/pi-web-search.
  • url_context: Gemini-only native URL Context.

Client configuration

Run /web inside Pi to select Exa Free, Bing, SearXNG, or a keyed provider. Configuration is stored by @bytetrue/pi-web-search under ~/.pi/byte-pi-web/config.json.

Default client routing requires no API key:

Exa Free -> Bing

Optional providers include SearXNG, Bocha, Tavily, Exa, Brave, Jina, and Firecrawl.

Development

npm run check --workspace pi-hybrid-web-search
npm run test --workspace pi-hybrid-web-search