> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Modular Recipes
> Build complex workflows by composing smaller, reusable recipes with the include: pattern
Build complex workflows by composing smaller, reusable recipes with the `include:` pattern.
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import Agent
agent = Agent(name="publisher", instructions="Run modular recipe steps.")
agent.start("Publish this article using the wordpress-publisher include.")
```
The user defines a main recipe with `include:` steps; PraisonAI runs each included recipe in order.
```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
graph LR
M[Main recipe] --> I[include]
I --> P[wordpress-publisher]
P --> O[📤 Output]
classDef agent fill:#8B0000,stroke:#7C90A0,color:#fff
classDef process fill:#189AB4,stroke:#7C90A0,color:#fff
classDef result fill:#10B981,stroke:#7C90A0,color:#fff
class M agent
class I,P process
class O result
```
## How It Works
```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
sequenceDiagram
participant User
participant Agent
participant Feature as Modular Recipes
User->>Agent: Request
Agent->>Feature: Process request
Feature-->>Agent: Result Agent-->>User: Response
```
If you publish a recipe that needs custom tools, prefer declaring them under the `tools_sources:` / `override_files:` directives in `TEMPLATE.yaml` — those load without requiring users to set `PRAISONAI_ALLOW_TEMPLATE_TOOLS`. Implicit `tools.py` loading is disabled by default for security (GHSA-xcmw-grxf-wjhj). See [Security Environment Variables](/docs/features/security-environment-variables#praisonai_allow_template_tools) for details.
## Quick Start
```yaml theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
steps:
- agent: content_writer
action: "Write article about {{topic}}"
- include: wordpress-publisher
input: "{{previous_output}}"
```
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import AgentFlow, include
workflow = AgentFlow(
name="Content Pipeline",
steps=[
content_writer_agent,
include("wordpress-publisher", input="{{previous_output}}")
]
)
result = workflow.run("Write about AI")
```
## Overview
Instead of duplicating common functionality across recipes, extract it into a standalone recipe and include it where needed:
```yaml theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
roles:
content_writer:
role: Content Writer
goal: Write articles
includes:
- wordpress-publisher
```
## Usage Patterns
### Include in Steps Format
```yaml theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
name: Content Pipeline
steps:
- agent: content_writer
action: "Write article about {{topic}}"
- include: wordpress-publisher
input: "{{previous_output}}"
```
### Include in Roles Format
```yaml theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
framework: praisonai
topic: "AI News"
roles:
topic_gatherer:
role: Topic Researcher
goal: Find news topics
tasks:
find_topics:
description: Search for AI news
content_writer:
role: Content Writer
goal: Write articles
tasks:
write:
description: Write about {{previous_output}}
includes:
- wordpress-publisher
```
### Include with Configuration
```yaml theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
includes:
- recipe: wordpress-publisher
input: "{{previous_output}}"
```
## Python API
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import AgentFlow, Include, include
workflow = AgentFlow(
name="Content Pipeline",
steps=[
content_writer_agent,
include("wordpress-publisher", input="{{previous_output}}")
]
)
result = workflow.run("Write about AI")
```
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import Include
step = Include(recipe="wordpress-publisher", input="Custom input here")
```
## call\_recipe Tool
Give agents the ability to call other recipes as a tool:
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from agent_recipes import call_recipe
from praisonaiagents import Agent
orchestrator = Agent(
name="Orchestrator",
instructions="Coordinate content publishing workflows",
tools=[call_recipe]
)
```
## run\_recipe Function
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from agent_recipes import run_recipe
result = run_recipe(
recipe_name="wordpress-publisher",
input_data="ARTICLE_TITLE: My Title\nARTICLE_CONTENT: ...",
output="status"
)
print(result['output'])
```
## Creating Reusable Recipes
```
wordpress-publisher/
├── TEMPLATE.yaml
├── agents.yaml
├── tools.py
└── README.md
```
**agents.yaml:**
```yaml theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
framework: praisonai
topic: "Publish article to WordPress"
roles:
publisher:
role: WordPress Publisher
goal: Validate and publish blog post
tools:
- create_wp_post
tasks:
validate_and_publish:
description: |
{{previous_output}}
Extract ARTICLE_TITLE and ARTICLE_CONTENT and call create_wp_post.
expected_output: Published post with ID and confirmation
```
## Cycle Detection
The include system automatically detects circular includes:
```yaml theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# recipe-a includes recipe-b
# recipe-b includes recipe-a
# → Error: "Circular include detected"
```
## Best Practices
Each recipe should do one thing well — publish, transform, or validate — not all three.
State the expected `{{previous_output}}` format so included recipes parse input reliably.
Included recipes should fail gracefully when required fields are missing.
Publishing or side-effect steps should be safe to retry without duplicating output.
## Available Recipes
```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai templates list
```
Key reusable recipes:
* `wordpress-publisher` — Publish content to WordPress
* `transcript-generator` — Generate transcripts from media
* `data-transformer` — Transform data between formats
## Related
Workflow fundamentals and step types
Browse available recipes