> ## Documentation Index
> Fetch the complete documentation index at: https://docs.praison.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Existing Recipes

> Step-by-step guide to running and using existing PraisonAI recipes

## How to Run an Existing Recipe

<Steps>
  <Step title="List Available Recipes">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    praisonai recipe list
    ```
  </Step>

  <Step title="Get Recipe Info">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    praisonai recipe info ai-video-editor
    ```
  </Step>

  <Step title="Run Recipe with Variables">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    praisonai recipe run ai-video-editor --var input=video.mp4 --var output=edited.mp4
    ```
  </Step>

  <Step title="View Output">
    Check the generated output in your working directory or specified output path.
  </Step>
</Steps>

## How to Run Recipes from GitHub

<Steps>
  <Step title="Run Directly from GitHub">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    praisonai recipe run github:MervinPraison/Agent-Recipes/ai-video-editor
    ```
  </Step>

  <Step title="Run with Custom Branch">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    praisonai recipe run github:MervinPraison/Agent-Recipes/ai-video-editor@main
    ```
  </Step>

  <Step title="Run with Variables">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    praisonai recipe run github:MervinPraison/Agent-Recipes/ai-video-editor --var input=video.mp4
    ```
  </Step>
</Steps>

## How to Run Recipes with Python

<Steps>
  <Step title="Import and Run">
    ```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    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
    ```
  </Step>
</Steps>

## Common Recipe Variables

| Recipe            | Variables                     | Example                   |
| ----------------- | ----------------------------- | ------------------------- |
| `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

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai recipe run <recipe> [OPTIONS]

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