Skip to content
Back to top

# Installation

## Installing build

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

uv

    $ 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.10

- 3.11

- 3.12

- 3.13

- 3.14

- PyPy 3.10

- PyPy 3.11