Skip to main content

​
Recipes CLI

Run pre-built AI-powered workflows (recipes) directly from the command line.

​
Prerequisites

  • PraisonAI installed: pip install praisonai
  • OpenAI API key: export OPENAI_API_KEY=your_key
  • External dependencies vary by recipe (ffmpeg, pandoc, etc.)

​
List Available Recipes

praison templates list

​
Get Recipe Info

praison templates info ai-podcast-cleaner

​
Run a Recipe

praison templates run <recipe-name> <input> [options]

​
Common Options

OptionDescription
--output, -oOutput directory
--dry-runShow plan without executing
--forceOverwrite existing output
--verbose, -vEnable verbose output
--presetUse a preset configuration

​
Video/Audio Recipes

​
ai-podcast-cleaner

Clean podcast audio with noise reduction, normalization, and transcription. 
# Basic usage
praison templates run ai-podcast-cleaner recording.wav

# With output directory
praison templates run ai-podcast-cleaner recording.mp3 --output ./cleaned/

# Aggressive cleanup
praison templates run ai-podcast-cleaner recording.wav --preset aggressive

# Dry run
praison templates run ai-podcast-cleaner recording.wav --dry-run

​
ai-video-to-gif

Convert video to optimized GIF. 
praison templates run ai-video-to-gif video.mp4
praison templates run ai-video-to-gif video.mp4 --start 10 --duration 3

​
ai-audio-splitter

Split audio by silence detection. 
praison templates run ai-audio-splitter long_audio.mp3
praison templates run ai-audio-splitter podcast.wav --min-silence 2.0

​
ai-video-thumbnails

Extract thumbnails from video. 
praison templates run ai-video-thumbnails video.mp4
praison templates run ai-video-thumbnails video.mp4 --count 10

​
ai-audio-normalizer

Normalize audio loudness. 
praison templates run ai-audio-normalizer audio.mp3
praison templates run ai-audio-normalizer audio.wav --target-lufs -14

​
Document Recipes

​
ai-pdf-to-markdown

Convert PDF to Markdown. 
praison templates run ai-pdf-to-markdown document.pdf
praison templates run ai-pdf-to-markdown document.pdf --ocr

​
ai-markdown-to-pdf

Convert Markdown to PDF. 
praison templates run ai-markdown-to-pdf document.md

​
ai-pdf-summarizer

Summarize PDF documents. 
praison templates run ai-pdf-summarizer document.pdf

​
ai-slide-to-notes

Convert slides to notes. 
praison templates run ai-slide-to-notes presentation.pdf

​
ai-doc-translator

Translate documents. 
praison templates run ai-doc-translator document.md --language es

​
Image Recipes

​
ai-image-optimizer

Optimize images for web. 
praison templates run ai-image-optimizer ./images/
praison templates run ai-image-optimizer photo.jpg --quality 80

​
ai-image-cataloger

Catalog images with AI captions. 
praison templates run ai-image-cataloger ./photos/

​
ai-screenshot-ocr

Extract text from screenshots. 
praison templates run ai-screenshot-ocr screenshot.png

​
ai-image-resizer

Batch resize images. 
praison templates run ai-image-resizer ./images/
praison templates run ai-image-resizer ./images/ --sizes "1920,1280,640"

​
Code/Repo Recipes

​
ai-repo-readme

Generate README for repository. 
praison templates run ai-repo-readme ./my-project

​
ai-changelog-generator

Generate changelog from git history. 
praison templates run ai-changelog-generator ./my-repo
praison templates run ai-changelog-generator ./my-repo --since v1.0.0

​
ai-code-documenter

Generate code documentation. 
praison templates run ai-code-documenter ./src/

​
ai-dependency-auditor

Audit project dependencies. 
praison templates run ai-dependency-auditor ./my-project

​
Data Recipes

​
ai-csv-cleaner

Clean CSV files. 
praison templates run ai-csv-cleaner data.csv
praison templates run ai-csv-cleaner data.csv --drop-duplicates

​
ai-json-to-csv

Convert JSON to CSV. 
praison templates run ai-json-to-csv data.json

​
ai-data-profiler

Profile data files. 
praison templates run ai-data-profiler data.csv

​
ai-schema-generator

Generate JSON Schema. 
praison templates run ai-schema-generator data.json

​
Web Recipes

​
ai-url-to-markdown

Extract article from URL. 
praison templates run ai-url-to-markdown https://example.com/article

​
ai-sitemap-scraper

Scrape sitemap URLs. 
praison templates run ai-sitemap-scraper https://example.com/sitemap.xml

​
Packaging Recipes

​
ai-folder-packager

Package folder with manifest. 
praison templates run ai-folder-packager ./my-project
praison templates run ai-folder-packager ./my-project --format tar.gz

​
Output Structure

All recipes produce:
  • Primary output files (varies by recipe)
  • run.json - Execution metadata
  • run.log - Execution log (if verbose)

​
run.json Schema

{
  "recipe": "ai-podcast-cleaner",
  "version": "1.0.0",
  "started_at": "2024-12-29T00:00:00Z",
  "completed_at": "2024-12-29T00:01:00Z",
  "status": "success",
  "input": "./recording.wav",
  "output_dir": "./outputs/ai-podcast-cleaner/20241229-000000/",
  "config": {},
  "outputs": [
    {"name": "cleaned.mp3", "path": "cleaned.mp3", "size": 1234567}
  ],
  "metrics": {"duration_sec": 60.5}
}

​
Troubleshooting

​
Missing External Dependencies

# Check dependencies
praison tools check

# Install ffmpeg (macOS)
brew install ffmpeg

# Install poppler (macOS)
brew install poppler

# Install pandoc (macOS)
brew install pandoc

​
Missing API Key

export OPENAI_API_KEY=your_key_here

​
Permission Errors

Use --force to overwrite existing output: 
praison templates run ai-podcast-cleaner recording.wav --force