Praison AI

praisonai upgrade

Update the managed PraisonAI CLI install in place, or check for a newer release

Keep your PraisonAI CLI current — praisonai upgrade updates the managed install in place using whichever tool manager provisioned it.

bash
praisonai upgrade
Diagram

Yes

No

📦 Current version

🔎 Check PyPI

Newer
release?

⬇️ Upgrade in place

✅ Already latest

✅ New version

Quick Start

  1. Upgrade in place

    Update to the newest release using the tool manager that installed the CLI:

    bash
    praisonai upgrade
  2. Check without changing anything

    Report whether a newer version exists — no install, no mutation:

    bash
    praisonai upgrade --check

    Example output:

    Update available: 1.2.0 -> 1.3.0
Run: praisonai upgrade

How It Works

Diagram
PyPITool Manager (uv/pipx/pip)praisonai upgradeUserPyPITool Manager (uv/pipx/pip)praisonai upgradeUserpraisonai upgradedetect_install() → uv / pipx / pipupgrade praisonaifetch latestnew versiondone“PraisonAI upgraded (1.2.0 -> 1.3.0).”

The command detects how the CLI was installed and runs the matching upgrade command:

Install typeUpgrade command run
uv-managed (one-line installer)uv tool upgrade praisonai
pipx-managed (one-line installer)pipx upgrade praisonai
plain pip (library / SDK install)pip install --upgrade praisonai

Flags

FlagDescription
--checkReport whether a newer version exists without upgrading. Exits 1 if PyPI can’t be reached.
--jsonGlobal flag — emit machine-readable output (current / latest / update_available).

Human output

bash
praisonai upgrade --check
You are on the latest version (1.3.0).

JSON output

bash
praisonai --json upgrade --check
json
{"current": "1.2.0", "latest": "1.3.0", "update_available": true}

Behaviour by Install Type

uv-managed (recommended)

The one-line installer provisions an isolated uv tool environment. praisonai upgrade runs uv tool upgrade praisonai — clean, in place, no other Python touched.

pipx-managed

When installed via pipx, the command runs pipx upgrade praisonai against that isolated venv.

pip-installed (library use)

A plain pip install praisonai upgrades via pip install --upgrade praisonai. This is best-effort and shares your active environment.

Update Hint on Start

Long-lived installs surface a non-blocking “update available” hint on start (text mode only), backed by a time-boxed cache at ~/.praison/state/update_check.json (24h TTL). It never performs network I/O at start-up and never blocks or raises.

Opt out with an environment variable:

bash
export PRAISONAI_NO_UPDATE_CHECK=1

Related

praisonai uninstall

Cleanly remove the managed CLI install

 Installer Internals

How the one-line installer picks a backend

 Installation

Install paths for CLI and SDK users

 Isolation Backends

uv, pipx, and venv explained