Quick Install

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

Diagram
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

macOS / Linux / WSL

bash
curl -fsSL https://raw.githubusercontent.com/MervinPraison/PraisonAI/main/install.sh | sh

Windows (PowerShell)

powershell
iwr -useb https://praison.ai/install.ps1 | iex

Installs praisonai[all] into %USERPROFILE%\.praisonai\venv and runs praisonai setup at the end. See Installer for parameters and env vars.

uvx (zero-install)

bash
uvx praisonai "2+2"

Runs PraisonAI in a temporary isolated environment — no install required. Powered by uv.

pipx

bash
pipx install praisonai

Isolated persistent install managed by pipx.

pip

bash
pip install "praisonai[all]"

npm

bash
npm install praisonai

What Gets Installed

ComponentDescription
praisonaiFull PraisonAI wrapper (pulls praisonai-code and praisonaiagents)
Isolation environmentuv tool or pipx-managed environment
~/.local/bin/praisonaiCLI 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:

Code runtime (no gateway/bots)
pip install praisonai-code
SDK only (embed in your app)
pip install praisonaiagents

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 for a full comparison.

Quick Start

After installation:

python
from praisonaiagents import Agent

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

Install Options

The installer’s only knobs are three environment variables.

Pin a specific version
bash
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.

Force a specific tool manager
bash
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.

Non-interactive / CI mode
bash
PRAISONAI_NONINTERACTIVE=1 curl -fsSL https://raw.githubusercontent.com/MervinPraison/PraisonAI/main/install.sh | sh

Suitable for CI. The script never prompts regardless.

Environment Variables

VariableDefaultDescription
PRAISONAI_VERSIONlatestPin a specific version (appended as praisonai==VERSION)
PRAISONAI_INSTALLERautoForce uv or pipx
PRAISONAI_NONINTERACTIVEunsetNon-interactive/CI mode

Manage Your Install

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

bash
praisonai upgrade          # update in place
praisonai upgrade --check  # is a newer version available?
praisonai uninstall        # remove cleanly

Next Steps