> ## 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.

# Run

> Run agents from files or prompts

The `run` command executes agents from YAML configuration files or direct prompts.

## Usage

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

## Arguments

| Argument | Description                             |
| -------- | --------------------------------------- |
| `TARGET` | Agent file (YAML) or direct prompt text |

## Options

| Option           | Short | Description                           | Default       |
| ---------------- | ----- | ------------------------------------- | ------------- |
| `--model`        | `-m`  | LLM model to use                      | `gpt-4o-mini` |
| `--framework`    | `-f`  | Framework: praisonai, crewai, autogen | `praisonai`   |
| `praisonai chat` | `-i`  | Enable interactive mode               | `false`       |
| `--verbose`      | `-v`  | Verbose output                        | `false`       |
| `--stream`       |       | Stream output                         | `true`        |
| `--no-stream`    |       | Disable streaming                     |               |
| `--trace`        |       | Enable tracing                        | `false`       |
| `--memory`       |       | Enable memory                         | `false`       |
| `--tools`        | `-t`  | Tools file path                       |               |
| `--max-tokens`   |       | Maximum output tokens                 | `16000`       |

## Examples

### Run from YAML file

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai run agents.yaml
```

### Run with a prompt

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai run "What is the capital of France?"
```

### Run with specific model

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai run "Explain quantum computing" --model gpt-4o
```

### Run in interactive mode

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai run agents.yaml
```

### Run with memory enabled

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai run "Remember my name is John" --memory
```

### Run with verbose output

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai run agents.yaml --verbose
```

### Run with custom tools

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai run agents.yaml --tools tools.py
```

## Agent File Format

Create an `agents.yaml` file:

```yaml theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
framework: praisonai
topic: Research Assistant
roles:
  researcher:
    backstory: Expert research analyst
    goal: Find accurate information
    role: Researcher
    tasks:
      research_task:
        description: Research the given topic
        expected_output: Comprehensive research summary
```

## See Also

* [Agents](/docs/cli/agents) - Agent management
* [Workflow](/docs/cli/workflow) - Workflow execution
* [Interactive TUI](/docs/cli/interactive-tui) - Interactive terminal interface