> ## Documentation Index
> Fetch the complete documentation index at: https://docs.praison.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Tools

> 55 production-ready AI tools for automation, content processing, and development

# 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.

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
flowchart LR
    subgraph Input
        CLI[CLI Command]
        SDK[Python SDK]
        HTTP[HTTP Server]
    end
    
    subgraph Runner["Recipe Runner"]
        VAL[Validate Input]
        EXEC[Execute Tool]
        OUT[Generate Output]
    end
    
    subgraph Output
        JSON[JSON Response]
        FILES[Artifact Files]
        STREAM[Stream Events]
    end
    
    CLI --> VAL
    SDK --> VAL
    HTTP --> VAL
    VAL --> EXEC
    EXEC --> OUT
    OUT --> JSON
    OUT --> FILES
    OUT --> STREAM
```

## Quick Start

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# 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 serve recipe
```

## Tool Clusters

<CardGroup cols={2}>
  <Card title="Video & Audio" icon="video" href="/docs/examples/agent-recipes/video-audio/ai-subtitle-generator">
    8 tools for video/audio processing, transcription, and enhancement
  </Card>

  <Card title="Documents" icon="file-lines" href="/docs/examples/agent-recipes/documents/ai-invoice-processor">
    8 tools for document parsing, analysis, and generation
  </Card>

  <Card title="Images" icon="image" href="/docs/examples/agent-recipes/images/ai-background-remover">
    8 tools for image processing, enhancement, and analysis
  </Card>

  <Card title="Developer" icon="code" href="/docs/examples/agent-recipes/developer/ai-commit-message-generator">
    8 tools for code generation, review, and documentation
  </Card>

  <Card title="Data & Analytics" icon="chart-bar" href="/docs/examples/agent-recipes/data/ai-report-generator">
    8 tools for data analysis, visualization, and transformation
  </Card>

  <Card title="Web & Content" icon="globe" href="/docs/examples/agent-recipes/web-content/ai-blog-generator">
    8 tools for SEO, content generation, and web automation
  </Card>

  <Card title="Productivity" icon="clock" href="/docs/examples/agent-recipes/productivity/ai-email-parser">
    7 tools for email, calendar, file organization, and automation
  </Card>
</CardGroup>

## Integration Models

Each tool supports 6 integration models:

| Model                  | Description             | Best For              |
| ---------------------- | ----------------------- | --------------------- |
| **Embedded SDK**       | Direct Python import    | Applications, scripts |
| **CLI Invocation**     | Command line execution  | Automation, CI/CD     |
| **Local HTTP Sidecar** | Local server mode       | Microservices         |
| **Remote Runner**      | Managed cloud execution | Production, scaling   |
| **Event-Driven**       | Queue/webhook triggers  | Async workflows       |
| **Plugin Mode**        | Agent tool integration  | Multi-agent systems   |

## Common Flags

| Flag            | Description                     |
| --------------- | ------------------------------- |
| `--input`       | JSON input string               |
| `--input-file`  | Path to JSON input file         |
| `--out-dir`     | Output directory for artifacts  |
| `--json`        | Output as JSON                  |
| `--stream`      | Enable streaming (if supported) |
| `--timeout-sec` | Request timeout                 |

## Output Contract

All tools return a consistent JSON structure:

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "ok": true,
  "run_id": "run_abc123",
  "recipe": "ai-blog-generator",
  "output": { /* tool-specific */ },
  "artifacts": [
    {"path": "output/blog.md", "type": "markdown"}
  ],
  "warnings": [],
  "error": null
}
```