Recipes Guide

Complete guide to working with PraisonAI recipes

Recipes package agents, tasks, and tools so you can run repeatable workflows from YAML.

python

from praisonaiagents import Agent

agent = Agent(name="Recipe Runner", instructions="Summarise what PraisonAI recipes provide.")
agent.start("What can I do with recipes?")

The user opens a recipe guide, configures roles, and runs praisonai recipe run with variables.

Diagram

Quick Start

Simple Usage

List and run a recipe from the CLI.

bash

praisonai recipe list
praisonai recipe run my-recipe

With Configuration
Pass variables into the recipe at run time.
bash
```
praisonai recipe run my-recipe --var topic="AI agents"
```

How It Works

Diagram

Recipe Guides

Learn how to create, use, manage, and debug recipes in PraisonAI.

Create Custom Recipes

Build your own recipes from scratch

Use Existing Recipes

Run and configure existing recipes

Add Tools to Recipes

Configure tools for your recipes

Manage Recipes

Update, edit, and delete recipes

Debug Recipes

Troubleshoot recipe issues

Different Ways to Create

Explore all recipe creation methods

Quick Reference

Task	Command
List recipes	`praisonai recipe list`
Add from GitHub	`praisonai recipe add github:user/repo/recipe`
Add local	`praisonai recipe add ./my-recipe`
Run recipe	`praisonai recipe run <name>`
Get info	`praisonai recipe info <name>`
Validate	`praisonai recipe validate <path>`
Init new	`praisonai recipe init <name>`

Best Practices

Keep agents.yaml the single source of truth

Define roles, goals, tools, and tasks in one agents.yaml. Recipes stay portable when everything lives in the recipe directory.

Validate before you run

praisonai recipe validate <path> catches schema errors before execution. Wire it into CI so broken recipes never ship.

Parameterise with variables

Use {{task}}-style placeholders and pass values with --var key=value so one recipe serves many inputs.