Skip to main content
praisonai upgrade updates the managed CLI in place using whichever tool manager installed it, and --check reports whether a newer release exists without touching anything.

​
Quick Start

1

Check for a newer version

praisonai upgrade --check
Queries PyPI (5s timeout) and prints Update available: X.Y.Z -> X.Y.Z+1 or You are on the latest version (X.Y.Z).
2

Upgrade in place

praisonai upgrade
Detects the manager (uv → pipx → pip) and runs the matching upgrade command.

​
How It Works

praisonai upgrade mirrors the one-line installer’s detection order and only ever touches the CLI binary.
Detected managerUpgrade command
uvuv tool upgrade praisonai
pipxpipx upgrade praisonai
pip (library install)pip install --upgrade praisonai
This is CLI self-management only — praisonaiagents (the SDK) is never touched by praisonai upgrade.

​
Options

praisonai upgrade takes a single flag.
FlagDescription
--checkReport whether a newer version exists without upgrading.

​
JSON output

Add --output json for machine-readable output. 
{"current": "4.6.145", "latest": "4.6.146", "update_available": true}

{"manager": "uv", "previous": "4.6.145", "current": "4.6.146"}
--check also warms the background update-check cache, so long-lived installs surface the update hint on next start without their own network round-trip.

​
Common Patterns

Check first, then upgrade in CI. 
if praisonai upgrade --check --output json | grep -q '"update_available": true'; then
  praisonai upgrade
fi
Non-interactive fleet upgrade — upgrade never prompts, so it is safe to run unattended. 
praisonai upgrade

​
Non-Managed Installs

When PraisonAI was installed with plain pip (library/embedded use), automatic upgrade is unsupported. 
Automatic upgrade is not supported for a 'pip' install.
Upgrade manually with: pip install --upgrade praisonai
If --check cannot reach PyPI, it exits non-zero: 
Could not check for updates (network error).

​
Best Practices

Run praisonai upgrade --check --output json and gate the upgrade on update_available so pipelines only reinstall when a new release exists.
The one-line installer provisions uv tool or pipx. Keep that managed environment so praisonai upgrade can update in place without manual pip commands.
Leave the background update hint on. --check warms its cache, so subsequent starts remind you to upgrade without any network call.

praisonai uninstall

Cleanly remove the managed install

Update Hint

Non-blocking “update available” notice

Installer Internals

How install.sh provisions the CLI

Quick Install

One-liner install