upgrade

snippbot upgrade

Upgrade Snippbot to the latest release published on PyPI (or a version you pin), without having to remember the right pipx / pip incantation.

snippbot upgrade                  # Upgrade to the latest version on PyPI
snippbot upgrade --check          # Just report if a newer version exists
snippbot upgrade --version 0.5.2  # Pin a specific target version
snippbot upgrade --yes            # Skip the confirmation prompt

Option	Default	Description
--check	off	Report installed vs. latest version and whether an update is available. Installs nothing.
--version <ver>	latest on PyPI	Pin a specific target version (e.g. for a rollback).
--yes / -y	off	Skip the confirmation prompt (script-friendly).

What it does

1. Reads the latest version from PyPI’s JSON API (https://pypi.org/pypi/snippbot/json). This API is authoritative and never stale.
2. If you are already up to date (and didn’t pin --version), it exits without doing anything.
3. Otherwise it stops the daemon first (so files aren’t locked mid-write).
4. Detects how Snippbot was installed (pipx vs. a pip virtualenv) and runs the right installer, always pinning the exact target version and passing --no-cache-dir.

Why this is more reliable than raw pipx

pip’s cached simple index can serve a stale version, so a plain pipx install snippbot or pipx upgrade snippbot sometimes installs an old release. snippbot upgrade resolves the exact version from PyPI’s JSON API and pins it with --no-cache-dir, which defeats both the cache and any index lag.

After upgrading

The command can’t re-read the new version from inside the still-running CLI process, so verify and restart manually:

snippbot --version
snippbot start

Rollback

Pin an older version to roll back:

snippbot upgrade --version 0.4.1 --yes

See Updating for backup and database-migration guidance around upgrades and rollbacks.