praisonai recipe run ai-broll-builder \
  --input '{"images": ["img1.png", "img2.png"], "duration_per_image": 5}' \
  --json

import sys
sys.path.insert(0, 'agent_recipes/templates/ai-broll-builder')
from tools import create_ken_burns, apply_pan_zoom, build_broll

# Ken Burns effect on single image
kb = create_ken_burns(
    image_path="image.png",
    output_path="kb_clip.mp4",
    duration=5.0,
    zoom_start=1.0,
    zoom_end=1.2
)

# Build B-roll from multiple images
broll = build_broll(
    images=["img1.png", "img2.png", "img3.png"],
    output_path="broll.mp4",
    duration_per_image=5.0,
    transition="crossfade"
)

{
  "type": "object",
  "properties": {
    "images": {"type": "array"},
    "duration_per_image": {"type": "number", "default": 5},
    "transition": {
      "type": "string",
      "enum": ["crossfade", "cut", "fade"]
    },
    "effects": {
      "type": "array",
      "items": {"type": "string"}
    }
  }
}

{
  "path": "/output/broll.mp4",
  "clips": 3,
  "total_duration": 15
}

# Requires ffmpeg
brew install ffmpeg  # macOS
apt install ffmpeg   # Linux