Agent Recipes CLI Reference

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

Installation

pip install praisonai agent-recipes

Core Commands

List Recipes

# List all available recipes
praison recipes list

# Output as JSON
praison recipes list --json

# Group by category
praison recipes list --group

Recipe Information

# Show recipe details
praison recipes info ai-blog-generator

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

Check Dependencies

# 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

# Show what a recipe will do
praison recipes explain ai-blog-generator

Initialize Recipe

# 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

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

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

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

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

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

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

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

# 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

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

{
  "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
}

Agent Recipes

Examples

Documentation Index

​Agent Recipes CLI Reference

​Installation

​Core Commands

​List Recipes

​Recipe Information

​Check Dependencies

​Explain Execution Plan

​Initialize Recipe

​Run Recipe

​Recipe Catalog

​Cluster 1: Video & Audio

​Cluster 2: Documents

​Cluster 3: Images

​Cluster 4: Developer Tools

​Cluster 5: Data & Analytics

​Cluster 6: Web & Content

​Cluster 7: Productivity

​Common Flags

​Environment Variables

​Output Structure

Agent Recipes CLI Reference

Installation

Core Commands

List Recipes

Recipe Information

Check Dependencies

Explain Execution Plan

Initialize Recipe

Run Recipe

Recipe Catalog

Cluster 1: Video & Audio

Cluster 2: Documents

Cluster 3: Images

Cluster 4: Developer Tools

Cluster 5: Data & Analytics

Cluster 6: Web & Content

Cluster 7: Productivity

Common Flags

Environment Variables

Output Structure