tavily-cli

library0.1.2pypypi✓ verified 84d ago

CLI and agent tools for the Tavily API — search, extract, crawl, map, and research from the command line. Current version 0.1.2, requires Python >=3.10. Active development on GitHub.

llm-agents http-networking

pip install tavily-cli

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · TAVILY-CLI

tavily-cli

llm-agentspythonv0.1.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

TavilyClient

✓ from tavily import TavilyClient

✗ from tavily_cli import TavilyClient

Wrong prefix; package uses 'tavily' not 'tavily_cli'

Initialize client with API key from environment and run a search.

import os from tavily import TavilyClient client = TavilyClient(api_key=os.environ.get('TAVILY_API_KEY', '')) result = client.search(query="Python typing best practices") print(result)

tavily --version

Debug

Known issues

breakingAPI key required for all endpoints. Missing key raises AuthenticationError.

fix

Set TAVILY_API_KEY environment variable or pass api_key directly.

affects: 0.1+

gotchaSearch results are truncated to 5 by default; no warning if more results exist.

fix

Pass max_results=N to search() to get more results.

affects: 0.1.0-0.1.2

deprecatedFunction 'crawl' is deprecated in favor of 'extract' in v0.1.2.

fix

Replace client.crawl() with client.extract().

affects: 0.1.2

Errors

Common errors & fixes

tavily.errors.AuthenticationError: API key is missing or invalid

TAVILY_API_KEY not set or incorrect

fix

Set TAVILY_API_KEY environment variable with a valid key from https://app.tavily.com.

tavily.errors.RateLimitError: API rate limit exceeded

Too many requests in short time

fix

Wait and retry or upgrade your Tavily plan.

AttributeError: module 'tavily' has no attribute 'TavilyClient'

Importing from wrong module (tavily_cli instead of tavily)

fix

Install 'tavily-python' and use: from tavily import TavilyClient

Upgrade

Version history

0.1.2latest on PyPI · released Apr 28, 2026

Audit

Dependencies

tavily-pythonrequiredCore Tavily API client

Agent activity

30 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/tavily-ai/tavily-cli ↗

packagehttps://pypi.org/project/tavily-cli/ ↗

homepagehttps://tavily.com ↗

docshttps://docs.tavily.com ↗