snippetbashTip

uv add — Add package dependencies to the `pyproject.toml` file. Packages are specified according to <https://

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

thecommandpyprojectuv adddependenciescliaddpackage

Problem

How to use the uv add command: Add package dependencies to the pyproject.toml file. Packages are specified according to <https://peps.python.org/pep-0508/>. More information: <https://docs.astral.sh/uv/reference/cli/#uv-add>.

Solution

uv add — Add package dependencies to the pyproject.toml file. Packages are specified according to <https://peps.python.org/pep-0508/>. More information: <https://docs.astral.sh/uv/reference/cli/#uv-add>.

Add the latest version of a package:

uv add {{package}}

Add multiple packages:

uv add {{package1 package2 ...}}

Add a package with a version requirement:

uv add {{package>=1.2.3}}

Add packages to an optional dependency group, which will be included when published:

uv add --optional {{optional}} {{package1 package2 ...}}

Add packages to a local group, which will not be included when published:

uv add --group {{group}} {{package1 package2 ...}}

Add packages to the dev group, shorthand for --group dev:

uv add --dev {{package1 package2 ...}}

Add package as editable:

uv add --editable {{path/to/package}}/

Enable an extra when installing package, may be provided multiple times:

uv add {{package}} --extra {{extra_feature}}

Code Snippets

Add the latest version of a package

uv add {{package}}

Add multiple packages

uv add {{package1 package2 ...}}

Add a package with a version requirement

uv add {{package>=1.2.3}}

Add packages to an optional dependency group, which will be included when published

uv add --optional {{optional}} {{package1 package2 ...}}

Add packages to a local group, which will not be included when published

uv add --group {{group}} {{package1 package2 ...}}

Context

tldr-pages: common/uv add

Revisions (0)

No revisions yet.