Installation¶

Installing build¶

The recommended way to install build is using uv, but you can also install it via pip or pipx:

$ uv tool install build

pipx

$ pipx install build

pip

$ pip install build

Optional Dependencies¶

build supports optional extras for different use cases:

build[virtualenv] - Use virtualenv for isolation instead of venv. This can be useful when using automation tools that rely on virtualenv (such as tox), or when your operating system’s Python package does not include venv in the standard installation.
```
$ pip install 'build[virtualenv]'
```
build[uv] - Bundle uv for use with --installer=uv if you don’t have another install of uv available.
```
$ pip install 'build[uv]'
```

Verifying Attestations¶

Attestations are available after 1.2.1 and can be verified with the gh CLI tool:

$ python -m pip --no-cache-dir download --no-deps build
$ gh attestation verify build*.whl --repo pypa/build

PEP 740 has been accepted. Support for PEP 740 attestations in build is being tracked in #987.

Installing via conda¶

On conda-forge, this package is called python-build, therefore it can be installed via conda or an equivalent:

$ conda install conda-forge::python-build

Bootstrapping¶

This package can build itself only with the tomli (can be omitted in Python 3.11+) and pyproject-hooks dependencies. The --skip-dependency-check flag should be used in this case.

Compatibility¶

build is verified to be compatible with the following Python versions:

3.9
3.10
3.11
3.12
3.13
3.14
PyPy 3.9
PyPy 3.10
PyPy 3.11