pi-tavily

Native Tavily search, extract, crawl, map, research, and usage tools for pi

Packages

Package details

extension

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

npm repohome report
$ pi install npm:pi-tavily
Package
pi-tavily
Version
1.0.1
Published
Jul 20, 2026
Downloads
128/mo · 128/wk
Author
glammm
License
MIT
Types
extension
Size
43.7 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

pi-tavily

Native Tavily tools for pi.

Tools

  • tavily_search — compact ranked web results with normalized URL deduplication
  • tavily_extract — content extraction from known URLs
  • tavily_map — website URL discovery
  • tavily_crawl — website traversal and content extraction
  • tavily_research — asynchronous cited research reports
  • tavily_usage — total configured keys, credit limit, and remaining credits

Search returns only the query and short source snippets. Full raw content is stored in a private temporary cache when requested, keeping model context bounded.

Install

pi install npm:pi-tavily

Or from GitHub:

pi install git:github.com/ratatulieoi/pi-tavily

Configure

Run the interactive command:

/tavily-key

Or create ~/.pi/agent/tavily.json:

{
  "keys": [
    "tvly-YOUR_API_KEY"
  ]
}

Multiple keys are rotated between requests. Research polling stays pinned to the key that created the task.

You can also set one or more comma-separated keys in TAVILY_API_KEY.

Commands

  • /tavily-key — validate and add a key, then reload pi
  • /tavily-usage — show total keys, total credit limit, and remaining credits

License

MIT