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

# Quick Install

> Install PraisonAI with a single command — isolated via uv tool or pipx

<Info>
  **One command. Everything installed. Isolated from your system Python. You're welcome. 🚀**
</Info>

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
graph LR
    A[curl install.sh | sh]:::tool --> B{Detect manager}:::agent
    B -->|uv found| C[uv tool]:::success
    B -->|pipx found| D[pipx]:::tool
    B -->|neither| E[bootstrap uv]:::process
    E --> C
    C --> F[~/.local/bin/praisonai]:::success
    D --> F
    F --> G[✅ Ready]:::success

    classDef agent fill:#8B0000,stroke:#7C90A0,color:#fff
    classDef tool fill:#189AB4,stroke:#7C90A0,color:#fff
    classDef process fill:#F59E0B,stroke:#7C90A0,color:#fff
    classDef success fill:#10B981,stroke:#7C90A0,color:#fff
```

## One-Liner Install

<Tabs>
  <Tab title="macOS / Linux / WSL">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    curl -fsSL https://raw.githubusercontent.com/MervinPraison/PraisonAI/main/install.sh | sh
    ```
  </Tab>

  <Tab title="Windows (PowerShell)">
    ```powershell theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    iwr -useb https://praison.ai/install.ps1 | iex
    ```

    Installs `praisonai[all]` into `%USERPROFILE%\.praisonai\venv` and runs `praisonai setup` at the end. See [Installer](/docs/install/installer#windows) for parameters and env vars.
  </Tab>

  <Tab title="uvx (zero-install)">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    uvx praisonai "2+2"
    ```

    Runs PraisonAI in a temporary isolated environment — no install required. Powered by [uv](https://github.com/astral-sh/uv).
  </Tab>

  <Tab title="pipx">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    pipx install praisonai
    ```

    Isolated persistent install managed by [pipx](https://pipx.pypa.io/).
  </Tab>

  <Tab title="pip">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    pip install "praisonai[all]"
    ```
  </Tab>

  <Tab title="npm">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    npm install praisonai
    ```
  </Tab>
</Tabs>

<Check>
  The installer automatically:

  * Detects your platform via `uname`
  * Picks a tool manager: `uv tool` → `pipx` → bootstrap `uv` if neither is present
  * Installs `praisonai` into an isolated environment
  * Drops a `~/.local/bin/praisonai` shim and wires it onto your PATH
  * Prints a "Get started" panel pointing at `praisonai setup`, `praisonai upgrade`, and `praisonai uninstall`
</Check>

## What Gets Installed

| Component                    | Description                                                               |
| ---------------------------- | ------------------------------------------------------------------------- |
| **praisonai**                | Full PraisonAI wrapper (pulls `praisonai-code` and `praisonaiagents`)     |
| **Isolation environment**    | `uv tool` or `pipx`-managed environment                                   |
| **`~/.local/bin/praisonai`** | CLI shim on PATH                                                          |
| **Shell rc PATH block**      | `~/.zshrc` / `~/.bashrc` (+ login profile) / `~/.config/fish/config.fish` |

## Lighter Install Alternatives

The one-liner installer always installs the full `praisonai` package. For a smaller footprint, use `pip` directly:

<CodeGroup>
  ```bash Code runtime (no gateway/bots) theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
  pip install praisonai-code
  ```

  ```bash SDK only (embed in your app) theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
  pip install praisonaiagents
  ```
</CodeGroup>

`praisonai-code` gives you the agent runtime and full CLI (`run`, `chat`, `code`, …) without gateway or messaging-bot integrations. `praisonaiagents` is the pure Python SDK with no CLI at all — import it directly in your own application. See [Installation](/docs/installation) for a full comparison.

## Quick Start

After installation:

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

agent = Agent(name="assistant", instructions="Be helpful")
response = agent.start("Hello!")
print(response)
```

<Warning>
  Set your API key first:

  ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
  export OPENAI_API_KEY=your_key
  ```
</Warning>

## Install Options

The installer's only knobs are three environment variables.

<AccordionGroup>
  <Accordion title="Pin a specific version">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    PRAISONAI_VERSION=0.14.0 curl -fsSL https://raw.githubusercontent.com/MervinPraison/PraisonAI/main/install.sh | sh
    ```

    Installs `praisonai==0.14.0` instead of the latest release.
  </Accordion>

  <Accordion title="Force a specific tool manager">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    PRAISONAI_INSTALLER=pipx curl -fsSL https://raw.githubusercontent.com/MervinPraison/PraisonAI/main/install.sh | sh
    ```

    Force `uv` or `pipx`. `pipx` errors if not installed; `uv` bootstraps itself when missing.
  </Accordion>

  <Accordion title="Non-interactive / CI mode">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    PRAISONAI_NONINTERACTIVE=1 curl -fsSL https://raw.githubusercontent.com/MervinPraison/PraisonAI/main/install.sh | sh
    ```

    Suitable for CI. The script never prompts regardless.
  </Accordion>
</AccordionGroup>

## Environment Variables

| Variable                   | Default | Description                                               |
| -------------------------- | ------- | --------------------------------------------------------- |
| `PRAISONAI_VERSION`        | latest  | Pin a specific version (appended as `praisonai==VERSION`) |
| `PRAISONAI_INSTALLER`      | auto    | Force `uv` or `pipx`                                      |
| `PRAISONAI_NONINTERACTIVE` | unset   | Non-interactive/CI mode                                   |

## Manage Your Install

After installing, keep the CLI current or remove it cleanly:

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai upgrade          # update in place
praisonai upgrade --check  # is a newer version available?
praisonai uninstall        # remove cleanly
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Build Your First Agent" icon="robot" href="/docs/quickstart">
    Create an AI agent in 3 lines of code
  </Card>

  <Card title="Isolation Backends" icon="box" href="/docs/install/isolation-backends">
    Compare uv and pipx
  </Card>

  <Card title="Installer Internals" icon="gear" href="/docs/install/installer">
    How install.sh works
  </Card>

  <Card title="Upgrade & Uninstall" icon="arrow-up" href="/docs/features/praisonai-upgrade">
    Self-manage your CLI install
  </Card>
</CardGroup>