praisonai upgrade

Update the PraisonAI CLI in place, or check for a newer release without upgrading

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.

Options

praisonai upgrade takes a single flag.

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

Related