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

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

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 to the latest release
praisonai upgrade

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

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

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

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

# Interactive: confirms before removing
praisonai uninstall

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

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

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

How Your Install Is Detected

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

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 ~/.praisonai/state/update_check.json (24-hour freshness, honours PRAISONAI_HOME)
• 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

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

Related