How to Upgrade Python Developer Tools
Each handbook page shows a version badge for the tools its commands depend on. If a command doesn’t match what you see, check your version and upgrade.
Check your version
uv --version
ruff --versionCompare with the table below.
Upgrade
| Tool | Current version | Upgrade command |
|---|---|---|
| hatch | 1.17 | uv tool upgrade hatch |
| maturin | 1.14 | uv tool upgrade maturin |
| mypy | 2.3 | uv lock --upgrade-package mypy |
| pdm | 2.28 | pdm self update |
| pip | 26.2 | python -m pip install --upgrade pip |
| pixi | 1.0 | pixi self-update |
| poetry | 2.4 | poetry self update |
| pre-commit | 4.6 | uv tool upgrade pre-commit |
| pyrefly | 1.1 | uv tool upgrade pyrefly |
| pyright | 1.1.411 | uv tool upgrade pyright |
| pytest | 9.1 | uv lock --upgrade-package pytest |
| ruff | 0.16 | uv tool upgrade ruff |
| twine | 7.0 | uv tool upgrade twine |
| ty | 0.0.65 | uv tool upgrade ty |
| uv | 0.12 | uv self update |
These commands assume the most common install method. A Homebrew install of uv needs brew upgrade uv, not uv self update. See How to upgrade uv for the full matrix.
Upgrade dev dependencies through the lockfile
Tools in a project’s dev dependencies (pytest, mypy) upgrade through the lockfile:
uv lock --upgrade-package pytest
uv syncLearn More
Last updated on