# Install praisonai-ts globally
npm install -g praisonai

# Set your API key
export TAVILY_API_KEY=your-api-key

praisonai-ts tools list

AI SDK Tools Registry

Built-in Tools:
  • tavily (Tavily)
    Web search, content extraction, crawling, and site mapping powered by Tavily
    Tags: search, web, extract, crawl | Package: @tavily/ai-sdk
  ...

praisonai-ts tools info tavily

Tool: Tavily

ID: tavily
Description: Web search, content extraction, crawling, and site mapping powered by Tavily
Package: @tavily/ai-sdk
Tags: search, web, extract, crawl
Docs: https://praison.ai/docs/js/tools/tavily

Required Environment Variables:
  ✓ TAVILY_API_KEY

Installation:
  npm install @tavily/ai-sdk

Capabilities:
  search, extract, crawl

praisonai-ts tools doctor

Tools Health Check

Summary: 3/12 packages installed, 5 with missing env vars

✓ tavily (Tavily)
✗ exa (Exa)
    Package not installed: npm install @exalabs/ai-sdk
    Missing env vars: EXA_API_KEY
...

praisonai-ts tools example tavily

import { Agent, tools } from 'praisonai';

const agent = new Agent({
  name: 'Researcher',
  instructions: 'Search the web for information.',
  tools: [tools.tavily()],
});

const result = await agent.run('What are the latest AI developments?');
console.log(result.text);

praisonai-ts tools test tavily

Dry run for tavily: OK
  Tool is registered and ready

Use --live flag to run actual API test

praisonai-ts tools test tavily --live

Live test for tavily...
Test passed!
Result: {
  "query": "test",
  "results": [...],
  "responseTime": 1.23
}

praisonai-ts run --tools tavily "Search for latest AI news"

name: ResearchAgent
instructions: You are a research assistant that searches the web.
tools:
  - tavily:
      maxResults: 10
      includeAnswer: true
      searchDepth: advanced

praisonai-ts run -c agent.yaml "What are the top AI frameworks in 2024?"

praisonai-ts run --tools tavily --output json "Search for AI news" | jq .

# News search
praisonai-ts run --tools "tavily:topic=news,timeRange=day" "Latest tech news"

# Domain-specific search
praisonai-ts run --tools "tavily:includeDomains=github.com,stackoverflow.com" "How to use TypeScript generics"

praisonai-ts run --tools "tavily,exa" "Compare search results for AI frameworks"

# Search multiple queries
cat queries.txt | while read query; do
  praisonai-ts run --tools tavily --output json "$query" >> results.jsonl
done

praisonai-ts run --model gpt-4o --tools tavily "Deep research on quantum computing"

Error: TAVILY_API_KEY environment variable is required

export TAVILY_API_KEY=your-api-key

Error: Tool "tavily" requires package "@tavily/ai-sdk"

npm install @tavily/ai-sdk

Error: Rate limit exceeded