Skip to main content

AI Tools

PraisonAI provides 55 production-ready AI tools organized into 7 clusters. Each tool can be used via CLI, Python SDK, or HTTP server.

Quick Start

# Install
pip install praisonai praisonai-tools

# List all tools
praisonai recipe list

# Run a tool
praisonai recipe run ai-blog-generator --input '{"topic": "AI trends"}'

# Start server
praisonai recipe serve

Tool Clusters

Integration Models

Each tool supports 6 integration models:
ModelDescriptionBest For
Embedded SDKDirect Python importApplications, scripts
CLI InvocationCommand line executionAutomation, CI/CD
Local HTTP SidecarLocal server modeMicroservices
Remote RunnerManaged cloud executionProduction, scaling
Event-DrivenQueue/webhook triggersAsync workflows
Plugin ModeAgent tool integrationMulti-agent systems

Common Flags

FlagDescription
--inputJSON input string
--input-filePath to JSON input file
--out-dirOutput directory for artifacts
--jsonOutput as JSON
--streamEnable streaming (if supported)
--timeout-secRequest timeout

Output Contract

All tools return a consistent JSON structure:
{
  "ok": true,
  "run_id": "run_abc123",
  "recipe": "ai-blog-generator",
  "output": { /* tool-specific */ },
  "artifacts": [
    {"path": "output/blog.md", "type": "markdown"}
  ],
  "warnings": [],
  "error": null
}