Quick Install - PraisonAI

One command. Everything installed. Isolated from your system Python. You’re welcome. 🚀

One-Liner Install

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

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 praisonai "2+2"

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

pipx install praisonai

Isolated persistent install managed by pipx.

pip install "praisonai[all]"

npm install praisonai

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

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:

pip install praisonai-code

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:

from praisonaiagents import Agent

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

Set your API key first:

export OPENAI_API_KEY=your_key

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 | sh

Installs 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 | sh

Force 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 | sh

Suitable 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

Next Steps

Build Your First Agent

Create an AI agent in 3 lines of code

Isolation Backends

Compare uv and pipx

Installer Internals

How install.sh works

Upgrade & Uninstall

Self-manage your CLI install

Windows SDK Quickstart

Installer Internals

​One-Liner Install

​What Gets Installed

​Lighter Install Alternatives

​Quick Start

​Install Options

​Environment Variables

​Manage Your Install

​Next Steps

Build Your First Agent

Isolation Backends

Installer Internals

Upgrade & Uninstall

One-Liner Install

What Gets Installed

Lighter Install Alternatives

Quick Start

Install Options

Environment Variables

Manage Your Install

Next Steps