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

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
}