Skip to main content
Install PraisonAI with one command, keep it current with praisonai upgrade, and remove it cleanly with praisonai uninstall. 
curl -fsSL https://raw.githubusercontent.com/MervinPraison/PraisonAI/main/install.sh | sh
This is the managed CLI experience. It does not replace pip install praisonai — that still works exactly as before for library and embedded use. praisonaiagents is untouched.

​
Quick Start

1

Install with one line

No Python knowledge needed. The installer provisions an isolated environment and puts praisonai on your PATH.
curl -fsSL https://raw.githubusercontent.com/MervinPraison/PraisonAI/main/install.sh | sh
Then start:
praisonai setup
2

Keep it current

Update the managed install in place:
praisonai upgrade
3

Remove it cleanly

Remove the managed environment and shim:
praisonai uninstall

​
The One-Liner

One command detects your platform and installs PraisonAI into an isolated, managed environment. 
curl -fsSL https://raw.githubusercontent.com/MervinPraison/PraisonAI/main/install.sh | sh
The installer:
  • Detects your platform, architecture, and shell
  • Provisions an isolated environment via uv tool install (bootstrapping uv when absent) or pipx
  • Is idempotent and safe to re-run
  • Wires PATH for bash, zsh, and fish
  • Prints a first-run hint (praisonai setup)

​
Environment Overrides

Env varPurpose
PRAISONAI_VERSION=x.y.zPin to a specific version
PRAISONAI_INSTALLER=uv|pipxForce a specific tool manager
PRAISONAI_NONINTERACTIVE=1CI/headless installs — no prompts
PRAISONAI_VERSION=4.6.0 curl -fsSL https://raw.githubusercontent.com/MervinPraison/PraisonAI/main/install.sh | sh

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

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

​
praisonai upgrade

Update the managed install in place using the detected tool manager (uv / pipx). 
praisonai upgrade
Check for a newer release without changing anything — useful for dry-runs and scripting: 
praisonai upgrade --check
FlagDescription
--checkReport whether a newer version exists without upgrading
JSON output is supported for scripting: 
praisonai --json upgrade --check

{"current": "4.6.0", "latest": "4.6.1", "update_available": true}
When installed via pip instead of the managed one-liner, praisonai upgrade points you to pip install --upgrade praisonai.

​
praisonai uninstall

Remove the managed environment and global praisonai shim. 
praisonai uninstall
Skip the confirmation prompt for non-interactive / CI use: 
praisonai uninstall --yes
FlagDescription
--yes, -ySkip the confirmation prompt (non-interactive/CI)
JSON output is supported: 
praisonai --json uninstall --yes

{"manager": "uv", "removed": "4.6.0"}

​
Update-Available Hint

PraisonAI hints when a newer version is out — without ever slowing down start-up. The hint:
  • Is non-blocking on start (text mode only)
  • Is backed by a time-boxed cache at ~/.praison/state/update_check.json (24-hour freshness)
  • Never performs network I/O at start-up, never blocks, and never raises
  • Refreshes the cache in a detached background process for the next run

​
Opt Out

Set one environment variable to disable the hint entirely: 
export PRAISONAI_NO_UPDATE_CHECK=1
Env varEffect
PRAISONAI_NO_UPDATE_CHECK=1Disables the background update check and hint

​
Which Install Do I Choose?

This feature lives entirely in the CLI (praisonai-code/cli) plus install.sh at the repo root. Choose the one-liner for a managed, single-command experience; choose pip when you want to control the virtual environment yourself.

​
Best Practices

The curl … | sh installer keeps PraisonAI in an isolated environment, so your global Python is untouched and praisonai upgrade / praisonai uninstall work cleanly.
Set PRAISONAI_VERSION=x.y.z and PRAISONAI_NONINTERACTIVE=1 for reproducible, prompt-free installs in pipelines.
Run praisonai --json upgrade --check in automation to detect newer releases without mutating the install.
Set PRAISONAI_NO_UPDATE_CHECK=1 to disable the update hint on machines where outbound network checks are unwanted.

Installation

All install options, including pip and npm.

Installer Internals

How install.sh detects backends and wires PATH.