Quick Install
Install PraisonAI with a single command — isolated via uv tool or pipx
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:#fffOne-Liner Install
macOS / Linux / WSL
curl -fsSL https://raw.githubusercontent.com/MervinPraison/PraisonAI/main/install.sh | shWindows (PowerShell)
iwr -useb https://praison.ai/install.ps1 | iexInstalls praisonai[all] into %USERPROFILE%\.praisonai\venv and runs praisonai setup at the end. See Installer for parameters and env vars.
uvx (zero-install)
uvx praisonai "2+2"Runs PraisonAI in a temporary isolated environment — no install required. Powered by uv.
pipx
pipx install praisonaiIsolated persistent install managed by pipx.
pip
pip install "praisonai[all]"npm
npm install praisonaiWhat 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:
pip install praisonai-codepip install praisonaiagentspraisonai-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:
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
PRAISONAI_VERSION=0.14.0 curl -fsSL https://raw.githubusercontent.com/MervinPraison/PraisonAI/main/install.sh | shInstalls praisonai==0.14.0 instead of the latest release.
Force a specific tool manager
PRAISONAI_INSTALLER=pipx curl -fsSL https://raw.githubusercontent.com/MervinPraison/PraisonAI/main/install.sh | shForce uv or pipx. pipx errors if not installed; uv bootstraps itself when missing.
Non-interactive / CI mode
PRAISONAI_NONINTERACTIVE=1 curl -fsSL https://raw.githubusercontent.com/MervinPraison/PraisonAI/main/install.sh | shSuitable for CI. The script never prompts regardless.
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:
praisonai upgrade # update in place
praisonai upgrade --check # is a newer version available?
praisonai uninstall # remove cleanly