Recipes CLI

Run AI-powered recipes from the command line

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

Recipes shipped with PraisonAI are trusted, but if you run a third-party or remotely fetched recipe, its tools.py will only execute if you have explicitly set PRAISONAI_ALLOW_TEMPLATE_TOOLS=1. This default-deny behaviour was introduced in PR #1579 (GHSA-xcmw-grxf-wjhj). Always inspect a recipe’s tools.py before opting in. See Security Environment Variables for details.

Tools registered via the wrapper ToolRegistry, shipped by praisonai-tools, or provided by core SDK plugins are now reachable from recipe tools: lists (PR #2059). Previously these worked only in the main agent build path. See Tool Resolver.

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

Option	Description
--output, -o	Output mode: silent, status, trace, verbose, debug, json
--dry-run	Show plan without executing
--force	Overwrite existing output
--verbose, -v	Alias for --output verbose
--preset	Use a preset configuration

Output Modes

Mode	Description
silent	No output (default, best performance)
status	Shows tool calls inline: ▸ tool → result ✓
trace	Timestamped execution trace: [HH:MM:SS] ▸ tool → result [0.2s] ✓
verbose	Full interactive output with panels
debug	Trace + metrics (tokens, cost, model)
json	Machine-readable JSONL events

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