Reviewing UV: The Quirkiest Python Package Manager Ever

Quick facts

screenshot comparing poetry and uvmage-1.jpg

Note: Screenshot comparing poetry (top) and uv (down). You can see the different implementations of the pyproject.toml and the performance (15s vs 1s).

Development

Common tasks we will find and use:

Example

Terminal window
mkdir prj
cd prj
uv init
uv venv
uv add pandas scikit-learn scipy duckdb numba numpy
uv sync
uv python install 3.11
uv python pin 3.11

Resources:

They Move Fast and Stick to the Standard

They have an amazing philosophy of using built-in Python tools. An example of this, previously, they used the [tool.uv] table inside the pyproject.toml like this:

[tool.uv]
dev-dependencies = [
    "pytest>=8.3.3",
]

to handle dev dependencies, now (uv 0.5.4 (c62c83c37 2024-11-20)) they replaced that in favor of dependency groups, becoming something like this:

[dependency-groups]
dev = [
    "pytest>=8.3.3",
]

[!NOTE] uv adopted the PEP-735: dependency groups in pyproject.toml in only 15 days. https://github.com/astral-sh/uv/issues/8090

Do you realize how great this is? Before, you were only able to install dev dependencies using uv, but after the change, you can use whatever tool you want, as long as they are Python-compliant, like pip.

How to Upgrade Only One Dependency

https://docs.astral.sh/uv/guides/projects/#managing-dependencies

To upgrade a package, run uv lock with the --upgrade-package flag:

uv lock --upgrade-package requests

The --upgrade-package flag will attempt to update the specified package to the latest compatible version, while keeping the rest of the lockfile intact.

Running commands

https://docs.astral.sh/uv/guides/projects/#running-commands

Terminal window
uv add flask
uv run -- flask run -p 3000
uv run app.py

How to migrate

You probably already have most of the files needed and use pip:

I would recommend fully migrate setup.py to pyproject.toml.

In that case, you can use the following commands:

In case you want to switch to pure uv management you can try this:

To move from poetry to uv, use the requirements.txt standard to migrate dependencies:

See Also