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

# praisonai SDK

> PraisonAI wrapper package - CLI, auto-generation, and deployment

# praisonai SDK

The praisonai package provides a high-level wrapper with CLI, auto-generation, and deployment utilities.

<Note>
  **New in v4.6.104.** `praisonai` now depends on the new `praisonai-code` package (pinned `>=0.0.2`), which ships the standalone code-execution runtime and full CLI backend. `pip install praisonai` still pulls everything you need — this note exists so you can install `praisonai-code` alone if you don't need the wrapper's gateway, bots, or integrations. See the [installation guide](/docs/installation) for a full three-package comparison and the [praisonai-code SDK page](/docs/sdk/praisonai-code/index) for what the middle layer provides.
</Note>

## Installation

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
pip install praisonai

# With all features
pip install "praisonai[all]"
```

## Quick Start

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonai import PraisonAI

# Create and run agents from YAML
praison = PraisonAI(agent_file="agents.yaml")
result = praison.run()
```

## Main Class

### PraisonAI

Main wrapper class for running agents.

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonai import PraisonAI

praison = PraisonAI(
    agent_file="agents.yaml",
    framework="praisonaiagents"  # or "crewai", "autogen"
)

result = praison.run()
```

#### Constructor

| Parameter    | Type   | Description                   |
| ------------ | ------ | ----------------------------- |
| `agent_file` | `str`  | Path to YAML agent definition |
| `framework`  | `str`  | Framework to use              |
| `auto`       | `bool` | Enable auto mode              |

## Modules

<CardGroup cols={2}>
  <Card title="CLI Module" icon="terminal" href="/docs/sdk/praisonai/cli">
    Command-line interface and PraisonAI class
  </Card>

  <Card title="Auto Module" icon="wand-sparkles" href="/docs/sdk/praisonai/auto">
    Automated agent generation from prompts
  </Card>

  <Card title="Deploy Module" icon="rocket" href="/docs/sdk/praisonai/deploy">
    Deployment utilities for APIs and services
  </Card>

  <Card title="Persistence Module" icon="database" href="/docs/sdk/praisonai/persistence">
    Database adapters and session management
  </Card>
</CardGroup>

## Framework Support

### PraisonAI Agents (Default)

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
pip install praisonai
```

### CrewAI Integration

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
pip install "praisonai-frameworks[crewai]"
```

### AutoGen Integration

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
pip install "praisonai-frameworks[autogen]"
```

## Related

* [praisonaiagents](/docs/sdk/praisonaiagents/index) - Core agent framework
* [CLI](/docs/cli/cli) - Command-line usage
