by Innominds
RELEASE 2026.11.20.3 · 20 NOVEMBER 2026

Upgrade notices, and the practice agent's Docker route fixed

tv --version now tells you when a newer TruVelocity is on PyPI and how to upgrade. Two fixes found by a first-time pip user make the practice project's Docker route start on any machine, and give the offline model the right result.

1command to know you are up to date: tv --version
2 sat most to ask PyPI; silent offline
15 / 15cases pass on Docker with the offline model: gate passes
1097automated tests pass
What's new

tv --version tells you when to upgrade

If PyPI has a newer release than the one installed, tv --version says so and prints the upgrade command.

The notice

"A newer version is available: X (you have Y). Upgrade with: pip install -U "truvelocity-tevv[ui]"". When you are up to date it prints only the version.

Never in the way

One anonymous request to pypi.org for the package's public data, with a 2-second limit. Offline, behind a firewall or if PyPI is down, you just see the version. Nothing about you or your project is sent.

Scripts keep working

The version line goes to standard output as before; the notice goes to standard error.

Turn it off

TV_NO_UPDATE_CHECK=1 turns it off (air-gapped machines), and it is off whenever CI is set. Pre-releases are never offered.

Fixes

The practice project on Docker

AreaChange
docker compose upThe practice project's proxy image is built on your machine and never pulled (pull_policy: build). Before, some Docker setups stopped with pull access denied for truvelocity-tevv/proxy; the workaround was docker compose build first.
Offline model on DockerThe agent image is now harbor-expense-agent:sha-dd806dd, whose offline model names the approved amount. On the old image, the clean build failed REV-01 with --scripted and the decision was No-go. Existing projects: add EXPENSE_IMAGE=ghcr.io/shankonduru/harbor-expense-agent:sha-dd806dd to .env, or run tv practice-project --force (your .env is kept).
Get started

Upgrade

Upgrade TruVelocity

pip install -U "truvelocity-tevv[ui,proxy]"

Check it (and, from now on, whether a newer one is out)

tv --version
Quality

How this release was checked

Lint (ruff, format, mypy strict, the core import rule) and the full suite: 1097 passed, none failed (6 database tests skipped: no Postgres, SQL Server or MySQL here; CI runs them). tv --version was checked against the real PyPI: an older version gets the notice, the current one prints only the version. The practice Compose file was checked with a proxy tag that exists in no registry: it built locally and all three services came up healthy. The Docker route with the offline model on the new image: 15 of 15 cases and the release bar passed.