Skip to main content
Discover community or built-in recipes and run them with your own inputs. 
from praisonaiagents import Agent

agent = Agent(name="Recipe Operator", instructions="Help run existing PraisonAI recipes.")
agent.start("List steps to run an existing recipe with custom variables.")
The user lists recipes, passes --var flags, and collects outputs from each task.

​
How It Works

​
How to Run an Existing Recipe

1

List Available Recipes

praisonai recipe list
2

Get Recipe Info

praisonai recipe info ai-video-editor
3

Run Recipe with Variables

praisonai recipe run ai-video-editor --var input=video.mp4 --var output=edited.mp4
4

View Output

Check the generated output in your working directory or specified output path.

​
How to Run Recipes from GitHub

1

Run Directly from GitHub

praisonai recipe run github:MervinPraison/Agent-Recipes/ai-video-editor
2

Run with Custom Branch

praisonai recipe run github:MervinPraison/Agent-Recipes/ai-video-editor@main
3

Run with Variables

praisonai recipe run github:MervinPraison/Agent-Recipes/ai-video-editor --var input=video.mp4

​
How to Run Recipes with Python

1

Import and Run

from praisonaiagents import Agent, AgentTeam
import yaml

# Load recipe
with open("agents.yaml") as f:
    config = yaml.safe_load(f)

# Run agents based on config

​
Common Recipe Variables

RecipeVariablesExample
ai-video-editor--var input, --var output--var input=video.mp4
research-agent--var topic, --var depth--var topic="AI trends"
code-reviewer--var repo, --var branch--var repo=./myproject

​
CLI Options

praisonai recipe run <recipe> [OPTIONS]

Options:
  --var KEY=VALUE        Set variable value
  --verbose              Enable verbose output

​
Best Practices

praisonai recipe info <name> lists the variables a recipe expects, so you pass the right --var flags on the first try.
Append @main (or a tag) to a github: recipe reference so runs stay reproducible even as the upstream repo changes.
Verbose mode shows each task and tool call, making it clear where an unexpected result came from.

Manage Recipes

Update and remove installed recipes

Debug Recipes

Troubleshoot a failing run