Skip to main content
PraisonAI’s installer keeps the CLI isolated from your global Python environment. Pick the backend that fits your workflow.

Backend Comparison

uv toolpipxvenv—no-venv
Isolation✅ Isolated✅ Isolated✅ Isolated❌ None
Persistence✅ Permanent✅ Permanent✅ Permanent✅ Permanent
Speed⚡ Fastest🐢 Slower🐢 Slower⚡ Fast
PATH managementuv tool update-shellpipx ensurepath~/.local/bin shimDepends on active env
Extra installuvpipxNoneNone
Who manages envuvpipxInstallerYou
When to pickYou use uv alreadyYou use pipx alreadyNo uv/pipx availableCI, Docker, scripts

Using Each Backend

uv tool install creates a fully isolated environment managed by uv. The fastest option.
# Auto-detected if uv is installed
curl -fsSL https://praison.ai/install.sh | bash

# Force explicitly
curl -fsSL https://praison.ai/install.sh | bash -s -- --backend uv

# Or directly (no installer needed)
uv tool install praisonai

pipx

pipx install creates an isolated venv managed by pipx. Familiar to Python developers.
# Auto-detected if uv is absent and pipx is installed
curl -fsSL https://praison.ai/install.sh | bash

# Force explicitly
curl -fsSL https://praison.ai/install.sh | bash -s -- --backend pipx

# Or directly (no installer needed)
pipx install praisonai

venv (fallback)

The installer creates ~/.praisonai/venv and symlinks ~/.local/bin/praisonai → venv/bin/praisonai.
# Auto-selected when uv and pipx are absent
curl -fsSL https://praison.ai/install.sh | bash

# Force explicitly
curl -fsSL https://praison.ai/install.sh | bash -s -- --backend venv

# Custom install directory
curl -fsSL https://praison.ai/install.sh | bash -s -- --backend venv --install-dir /opt/praisonai

No isolation (—no-venv)

Installs directly into the active Python environment. Useful in Docker, CI, or when you manage your own venv.
curl -fsSL https://praison.ai/install.sh | bash -s -- --no-venv

# Or directly
pip install "praisonai[all]"

uvx (zero-install one-shot)

Runs PraisonAI in a temporary environment without a persistent install. Good for one-off commands.
uvx praisonai "2+2"

Environment Variable

Override the backend without changing the install command:
PRAISONAI_BACKEND=pipx curl -fsSL https://praison.ai/install.sh | bash
PRAISONAI_BACKEND=venv curl -fsSL https://praison.ai/install.sh | bash
PRAISONAI_BACKEND=uv   curl -fsSL https://praison.ai/install.sh | bash
Valid values: uv, pipx, venv, system, auto (default).

PATH Management

All backends expose the CLI at ~/.local/bin/praisonai. The installer appends an idempotent block to your shell rc (unless --no-modify-path):
# >>> PraisonAI PATH >>>
export PATH="$HOME/.local/bin:$PATH"
# <<< PraisonAI PATH <<<
Fish shell variant:
# >>> PraisonAI PATH >>>
set -gx PATH $HOME/.local/bin $PATH
# <<< PraisonAI PATH <<<
Skip PATH modification:
curl -fsSL https://praison.ai/install.sh | bash -s -- --no-modify-path
# or
PRAISONAI_NO_MODIFY_PATH=1 curl -fsSL https://praison.ai/install.sh | bash

Uninstalling

uv tool uninstall praisonai

Quick Install

One-liner install command

Installer Internals

Full install.sh reference