@vipinsights/gemini-web-search-grounding

Minimal web_search for pi using Gemini's Grounding with Google Search. Gemini models only; no URL fetching.

Packages

Package details

extension

Install @vipinsights/gemini-web-search-grounding from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@vipinsights/gemini-web-search-grounding
Package
@vipinsights/gemini-web-search-grounding
Version
1.1.0
Published
Nov 3, 2026
Downloads
479/mo · 479/wk
Author
michael.couillard
License
MIT
Types
extension
Size
7.4 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

gemini-web-search-grounding

Minimal web_search tool for pi using Gemini's Grounding with Google Search. Derived from ttttmr/pi-web-search (MIT).

https://www.npmjs.com/package/@vipinsights/gemini-web-search-grounding

Scope

  • One tool: web_search(query). Returns a grounded answer plus source links.
  • Gemini only: runs on pi's current model, and only when it uses the google-generative-ai API. Any other model returns an error.
  • Auth: the env var pi uses for Gemini (GEMINI_API_KEY). No /login credentials, no config files.
  • No url_context, no URL parameters, no URL fetching, no other vendors.

Install

Requires Pi 1.5.0 or newer. Do not load it alongside pi-web-search; both register web_search.

pi install npm:@vipinsights/gemini-web-search-grounding

Replace the previous web search tool

  1. List installed packages and find the old one (e.g. pi-web-search):

    pi list

  2. Remove it:

    pi remove npm:pi-web-search

  3. Install this one:

    pi install npm:@vipinsights/gemini-web-search-grounding

  4. Set GEMINI_API_KEY, restart Pi, and select a Gemini model.

  5. If web_search is still registered twice, check packages and extensions in ~/.pi/agent/settings.json (and the project's .pi/settings.json) for leftover pi-web-search entries and delete them.

Publish to npm

  1. Log in (once): npm login
  2. Confirm name and version in package.json; the name must be unused on npm.
  3. Run checks: npm test && npm run typecheck
  4. Preview the tarball: npm pack --dry-run (only src and README.md should ship)
  5. Publish: npm publish --access public
  6. Verify: pi install npm:@vipinsights/gemini-web-search-grounding
  7. For later releases: npm version patch|minor|major, then npm publish --access public

The pi-package keyword in package.json makes it discoverable as a Pi package.

Test

npm test
npm run typecheck