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

List Available Recipes

bash

praison templates list

Get Recipe Info

bash

praison templates info ai-podcast-cleaner

Run a Recipe

bash

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.

bash

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

bash

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.

bash

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.

bash

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

ai-audio-normalizer

Normalize audio loudness.

bash

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.

bash

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.

bash

praison templates run ai-markdown-to-pdf document.md

ai-pdf-summarizer

Summarize PDF documents.

bash

praison templates run ai-pdf-summarizer document.pdf

ai-slide-to-notes

Convert slides to notes.

bash

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

ai-doc-translator

Translate documents.

bash

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

Image Recipes

ai-image-optimizer

Optimize images for web.

bash

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.

bash

praison templates run ai-image-cataloger ./photos/

ai-screenshot-ocr

Extract text from screenshots.

bash

praison templates run ai-screenshot-ocr screenshot.png

ai-image-resizer

Batch resize images.

bash

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.

bash

praison templates run ai-repo-readme ./my-project

ai-changelog-generator

Generate changelog from git history.

bash

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.

bash

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

ai-dependency-auditor

Audit project dependencies.

bash

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

Data Recipes

ai-csv-cleaner

Clean CSV files.

bash

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.

bash

praison templates run ai-json-to-csv data.json

ai-data-profiler

Profile data files.

bash

praison templates run ai-data-profiler data.csv

ai-schema-generator

Generate JSON Schema.

bash

praison templates run ai-schema-generator data.json

Web Recipes

ai-url-to-markdown

Extract article from URL.

bash

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

ai-sitemap-scraper

Scrape sitemap URLs.

bash

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

Packaging Recipes

ai-folder-packager

Package folder with manifest.

bash

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

json

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

bash

# 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

bash

export OPENAI_API_KEY=your_key_here

Permission Errors

Use --force to overwrite existing output:

bash

praison templates run ai-podcast-cleaner recording.wav --force