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

# Agent Recipes CLI

> Complete CLI reference for Agent Recipes

# Agent Recipes CLI Reference

Complete command reference for managing and running Agent Recipes from the command line.

## Installation

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
pip install praisonai agent-recipes
```

## Core Commands

### List Recipes

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# List all available recipes
praison recipes list

# Output as JSON
praison recipes list --json

# Group by category
praison recipes list --group
```

### Recipe Information

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Show recipe details
praison recipes info ai-blog-generator

# Output as JSON
praison recipes info ai-blog-generator --json
```

### Check Dependencies

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Check if dependencies are satisfied
praison recipes doctor ai-subtitle-generator

# Example output:
# ✓ env:OPENAI_API_KEY
# ✓ package:openai
# ✗ external:ffmpeg
# ✗ tool:whisper_tool
```

### Explain Execution Plan

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Show what a recipe will do
praison recipes explain ai-blog-generator
```

### Initialize Recipe

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Copy recipe to current directory for customization
praison recipes init ai-blog-generator

# Specify output directory
praison recipes init ai-blog-generator --output ./my-recipe
```

### Run Recipe

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Basic run
praison recipes run ai-blog-generator --input "AI in Healthcare"

# With output directory
praison recipes run ai-subtitle-generator video.mp4 --output ./subtitles/

# Dry run (check only, no execution)
praison recipes run ai-video-compressor video.mp4 --dry-run

# Force execution for dry-run-default recipes
praison recipes run ai-data-anonymizer data.csv --write

# With consent flag (for sensitive recipes)
praison recipes run ai-voice-cloner sample.mp3 --consent
```

## Recipe Catalog

### Cluster 1: Video & Audio

| Recipe                          | Description                     | Key Dependencies |
| ------------------------------- | ------------------------------- | ---------------- |
| `ai-video-highlight-extractor`  | Extract key moments from videos | ffmpeg, whisper  |
| `ai-video-chapter-generator`    | Generate YouTube chapters       | whisper, LLM     |
| `ai-subtitle-generator`         | Generate SRT/VTT subtitles      | whisper          |
| `ai-video-compressor`           | AI-optimized compression        | ffmpeg           |
| `ai-voice-cloner`               | Clone voice for TTS             | openai           |
| `ai-background-music-generator` | Generate royalty-free music     | openai           |
| `ai-podcast-transcriber`        | Transcribe with diarization     | whisper          |
| `ai-audio-enhancer`             | Noise removal, normalization    | ffmpeg           |

**Example:**

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Generate subtitles
praison recipes run ai-subtitle-generator podcast.mp3 --format srt

# Generate video chapters
praison recipes run ai-video-chapter-generator lecture.mp4
```

### Cluster 2: Documents

| Recipe                  | Description                 | Key Dependencies |
| ----------------------- | --------------------------- | ---------------- |
| `ai-invoice-processor`  | Extract invoice data        | tesseract, LLM   |
| `ai-resume-parser`      | Parse CVs to JSON           | pdftotext, LLM   |
| `ai-contract-analyzer`  | Extract contract terms      | pdftotext, LLM   |
| `ai-meeting-summarizer` | Summarize with action items | whisper, LLM     |
| `ai-slide-generator`    | Generate presentations      | python-pptx, LLM |
| `ai-ebook-converter`    | Convert to EPUB/MOBI        | pandoc, calibre  |
| `ai-form-filler`        | Auto-fill PDF forms         | pypdf, LLM       |
| `ai-faq-generator`      | Generate FAQ from docs      | LLM              |

**Example:**

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Process invoice
praison recipes run ai-invoice-processor receipt.pdf --output invoice.json

# Parse resume
praison recipes run ai-resume-parser cv.pdf --format json
```

### Cluster 3: Images

| Recipe                       | Description            | Key Dependencies |
| ---------------------------- | ---------------------- | ---------------- |
| `ai-background-remover`      | Remove backgrounds     | rembg, pillow    |
| `ai-image-upscaler`          | AI upscale 2x-8x       | realesrgan       |
| `ai-watermark-remover`       | Remove watermarks      | LLM vision       |
| `ai-watermark-adder`         | Add watermarks/logos   | pillow           |
| `ai-image-captioner`         | Generate alt-text      | LLM vision       |
| `ai-color-palette-extractor` | Extract colors         | pillow           |
| `ai-face-blur`               | Blur faces for privacy | opencv           |
| `ai-image-tagger`            | Auto-tag images        | LLM vision       |

**Example:**

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Remove background
praison recipes run ai-background-remover photo.jpg --output transparent.png

# Generate captions
praison recipes run ai-image-captioner images/ --output captions.json
```

### Cluster 4: Developer Tools

| Recipe                        | Description               | Key Dependencies |
| ----------------------------- | ------------------------- | ---------------- |
| `ai-commit-message-generator` | Generate commit messages  | git, LLM         |
| `ai-code-refactorer`          | Refactor with suggestions | LLM              |
| `ai-api-doc-generator`        | Generate OpenAPI docs     | LLM              |
| `ai-test-generator`           | Generate unit tests       | LLM              |
| `ai-code-reviewer`            | Automated code review     | git, LLM         |
| `ai-sql-generator`            | Natural language to SQL   | LLM              |
| `ai-regex-generator`          | Generate regex patterns   | LLM              |
| `ai-api-tester`               | Auto-test API endpoints   | requests, LLM    |

**Example:**

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Generate commit message
praison recipes run ai-commit-message-generator .

# Generate tests
praison recipes run ai-test-generator src/utils.py --output tests/
```

### Cluster 5: Data & Analytics

| Recipe                       | Description               | Key Dependencies |
| ---------------------------- | ------------------------- | ---------------- |
| `ai-report-generator`        | Generate business reports | pandas, LLM      |
| `ai-chart-generator`         | Generate visualizations   | matplotlib, LLM  |
| `ai-sentiment-analyzer`      | Analyze text sentiment    | LLM              |
| `ai-data-anonymizer`         | Anonymize PII             | pandas, LLM      |
| `ai-log-analyzer`            | Analyze log patterns      | LLM              |
| `ai-excel-formula-generator` | Generate Excel formulas   | LLM              |
| `ai-etl-pipeline`            | Transform data formats    | pandas           |
| `ai-duplicate-finder`        | Find duplicate files      | hashlib, LLM     |

**Example:**

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Analyze sentiment
praison recipes run ai-sentiment-analyzer reviews.csv --output analysis.json

# Generate chart
praison recipes run ai-chart-generator sales.csv --type bar --output chart.png
```

### Cluster 6: Web & Content

| Recipe                             | Description             | Key Dependencies |
| ---------------------------------- | ----------------------- | ---------------- |
| `ai-seo-optimizer`                 | Optimize for SEO        | LLM              |
| `ai-blog-generator`                | Generate blog posts     | LLM              |
| `ai-newsletter-generator`          | Generate newsletters    | LLM              |
| `ai-social-media-generator`        | Generate social posts   | LLM              |
| `ai-product-description-generator` | E-commerce descriptions | LLM              |
| `ai-rss-aggregator`                | Aggregate RSS feeds     | feedparser, LLM  |
| `ai-sitemap-generator`             | Generate XML sitemaps   | requests         |
| `ai-meta-tag-generator`            | Generate meta tags      | LLM              |

**Example:**

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Generate blog post
praison recipes run ai-blog-generator --input "Future of AI"

# Generate social media posts
praison recipes run ai-social-media-generator --input "Product launch announcement"
```

### Cluster 7: Productivity

| Recipe                  | Description          | Key Dependencies |
| ----------------------- | -------------------- | ---------------- |
| `ai-email-parser`       | Extract email data   | LLM              |
| `ai-calendar-scheduler` | Parse events to iCal | LLM              |
| `ai-file-organizer`     | Auto-organize files  | LLM              |
| `ai-note-summarizer`    | Summarize notes      | LLM              |
| `ai-translation-batch`  | Batch translate docs | LLM              |
| `ai-qr-code-generator`  | Generate QR codes    | qrcode           |
| `ai-barcode-scanner`    | Scan barcodes        | pyzbar           |

**Example:**

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Parse emails
praison recipes run ai-email-parser inbox.eml --output parsed.json

# Generate QR code
praison recipes run ai-qr-code-generator --input "https://example.com"
```

## Common Flags

| Flag             | Description                              |
| ---------------- | ---------------------------------------- |
| `--input`, `-i`  | Input file or value                      |
| `--output`, `-o` | Output directory                         |
| `--format`       | Output format (json, csv, etc.)          |
| `--model`        | LLM model to use                         |
| `--provider`     | LLM provider (openai, anthropic, google) |
| `--dry-run`      | Check dependencies only                  |
| `--write`        | Execute (for dry-run-default recipes)    |
| `--consent`      | Acknowledge consent requirements         |
| `--json`         | Output as JSON                           |

## Environment Variables

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Required for most recipes
export OPENAI_API_KEY=sk-...

# Alternative providers
export ANTHROPIC_API_KEY=sk-ant-...
export GOOGLE_API_KEY=AIza...

# Optional
export TAVILY_API_KEY=tvly-...  # For web search recipes
```

## Output Structure

All recipes generate a `run.json` file with execution metadata:

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "recipe": "ai-blog-generator",
  "version": "1.0.0",
  "timestamp": "2024-12-29T12:00:00Z",
  "inputs": {"topic": "AI in Healthcare"},
  "outputs": {"file": "output/blog.md"},
  "status": "success",
  "duration_ms": 3500
}
```