Skip to main content

npm

@tavily/pi-extension

Get API Key

Sign up at tavily.com

Introduction

Pi is a minimal terminal coding agent and harness that you can extend with TypeScript extensions, skills, prompt templates, and themes. Tavily integrates with Pi through the official npm package:
Install it in Pi with:

What this adds to Pi

The Tavily Pi extension adds two Tavily-powered tools:
  • web_search — search the web with Tavily Search
  • web_fetch — extract content from one or more URLs with Tavily Extract
These are Pi extension tools, not Pi built-in tools.

Requirements

  • Pi installed locally
  • A Tavily API key

Authentication

Version 1 uses an API key via environment variable:
OAuth or Pi-native login for Tavily is not included yet.

Install

If Pi is not installed yet, install it first:
Export your Tavily API key in the same shell where you will launch Pi:
Install the published npm package into Pi:
After installation, make sure the extension resource is enabled:
If the package is installed but web_search or web_fetch do not appear, this is the first thing to check.
Start a fresh Pi session in a clean directory:
Then ask Pi:
You should see web_search and web_fetch in the available tools.

Example prompts

Fetch

Troubleshooting

If Pi says it cannot access the web or Tavily tools do not appear, check these in order:
  1. Is the package installed?
  2. Is the extension resource enabled?
  3. Is the API key set in the same shell where Pi is launched?
  4. Are you starting a fresh session?

Learn more