Upgrade & Uninstall

One-line install, in-place upgrade, clean uninstall — plus a non-blocking new-version hint

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. Check for a newer release

   --check reports whether an update exists without changing anything.

   praisonai upgrade --check
   
3. Upgrade in place

   Run without flags to update via the detected tool manager (uv tool / pipx).

   praisonai upgrade
   
4. Uninstall cleanly

   Remove the managed environment and the global praisonai 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 var	Purpose
PRAISONAI_VERSION=x.y.z	Pin to a specific version
PRAISONAI_INSTALLER=uv|pipx	Force a specific tool manager
PRAISONAI_NONINTERACTIVE=1	CI/headless installs — no prompts

Pin a version

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

---

Commands

upgrade

Updates the managed install in place, or reports availability with --check.

# Upgrade to the latest release
praisonai upgrade

# Report-only: never mutates anything
praisonai upgrade --check

# Machine-readable output for scripts
praisonai upgrade --check --json

--check JSON reports the current and latest versions plus whether an update is available:

{ "current": "2.4.0", "latest": "2.5.0", "update_available": true }

An actual upgrade reports the manager and version transition:

{ "manager": "uv", "previous": "2.4.0", "current": "2.5.0" }

Flag	Description
--check	Report whether a newer version exists without upgrading

uninstall

Removes the managed environment and shim. Use --yes to skip the prompt.

# Interactive: confirms before removing
praisonai uninstall

# Non-interactive (CI): skip the confirmation prompt
praisonai uninstall --yes

# Machine-readable output
praisonai uninstall --yes --json

JSON output records the manager and the removed version:

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

Flag	Description
--yes, -y	Skip the confirmation prompt (non-interactive/CI)

Both commands are grouped under Get started in praisonai --help. When installed via pip instead of the managed one-liner, praisonai upgrade points you to pip install --upgrade praisonai.

---

How Your Install Is Detected

Detection mirrors the installer: isolated tool managers are preferred, with pip as the fallback for library installs.

Manager	Upgrade	Uninstall
uv tool	uv tool upgrade praisonai	uv tool uninstall praisonai
pipx	pipx upgrade praisonai	pipx uninstall praisonai
pip (fallback)	pip install --upgrade praisonai	pip uninstall -y praisonai

---

CI Usage

Combine --yes and --json for non-interactive automation.

# Fail the job if an update is pending
praisonai upgrade --check --json

# Tear down the managed install without prompts
praisonai uninstall --yes --json

---

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 var	Effect
PRAISONAI_NO_UPDATE_CHECK=1	Disables 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

Use the one-liner for a managed experience

The curl … | sh installer keeps PraisonAI in an isolated environment, so your global Python is untouched and praisonai upgrade / praisonai uninstall work cleanly.

Pin versions in CI

Set PRAISONAI_VERSION=x.y.z and PRAISONAI_NONINTERACTIVE=1 for reproducible, prompt-free installs in pipelines.

Script upgrade checks with --check

Run praisonai --json upgrade --check in automation to detect newer releases without mutating the install.

Silence the hint in shared environments

Set PRAISONAI_NO_UPDATE_CHECK=1 to disable the update hint on machines where outbound network checks are unwanted.

---

Related

One-line Installer

Install PraisonAI with a single command via uv or pipx.

Isolation Backends

How the CLI is isolated from your project’s Python environment.

Installation

All install options, including pip and npm.