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

# Deploy Module

> Deployment utilities for PraisonAI agents

# Deploy Module

The Deploy module provides utilities for deploying PraisonAI agents as APIs and services.

## Installation

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

## Quick Start

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import Agent

agent = Agent(
    name="Assistant",
    instructions="You are a helpful assistant."
)

# Deploy as HTTP API
agent.launch(path="/ask", port=8000)
```

## CLI Deployment

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Deploy with CLI
praisonai --deploy

# Deploy with specific port
praisonai --deploy --port 8080
```

## Deployment Options

### Single Agent

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import Agent

agent = Agent(instructions="You are helpful.")
agent.launch(
    path="/agent",
    port=8000,
    host="0.0.0.0"
)
```

### Multiple Agents

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import Agent, AgentTeam

agents = AgentTeam(agents=[
    Agent(name="Research", instructions="Research topics"),
    Agent(name="Writer", instructions="Write content")
])

agents.launch(path="/team", port=8000)
```

### MCP Server

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import Agent

agent = Agent(instructions="You are helpful.")
agent.launch(port=8080, protocol="mcp")
```

## Configuration

### Environment Variables

| Variable            | Description                |
| ------------------- | -------------------------- |
| `PRAISONAI_PORT`    | Default port (8000)        |
| `PRAISONAI_HOST`    | Default host (0.0.0.0)     |
| `PRAISONAI_API_KEY` | API key for authentication |

### Launch Options

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
agent.launch(
    path="/endpoint",      # URL path
    port=8000,             # Port number
    host="0.0.0.0",        # Bind address
    debug=False,           # Debug mode
    cors_origins=["*"],    # CORS settings
    api_key="secret",      # Authentication
    protocol="http"        # http or mcp
)
```

## Docker Deployment

```dockerfile theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
FROM python:3.11-slim

WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt

COPY . .
EXPOSE 8000

CMD ["python", "agent.py"]
```

## Cloud Deployment

See deployment guides:

* [AWS Deployment](/docs/deploy/aws)
* [Google Cloud](/docs/deploy/googlecloud)
* [MCP Server Deploy](/docs/deploy/mcp-server-deploy)

## See Also

* [Agent Launch API](/docs/api/praisonaiagents/launch/endpoints) - HTTP API reference
* [MCP Server API](/docs/api/praisonaiagents/mcp/endpoints) - MCP API reference
* [CLI Module](/docs/sdk/praisonai/cli) - Command-line interface
