Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

build

build.pypa.io

  • Free plan
  • Windows
  • macOS
  • Linux
  • API
7.6 Club score Visit build.pypa.io

What build is

build is a free, open-source Python packaging frontend for turning a project described by pyproject.toml into distribution packages. By default, it creates a source distribution and then builds a wheel from that source. The process uses standardized PEP 517 hooks, allowing build backends beyond setuptools. Each build normally runs in a temporary isolated virtual environment where the backend and its dependencies are installed; that environment is removed afterward. build concentrates on package creation rather than dependency or virtual-environment management. Developers can use its Python API from build tools, continuous-integration systems, and automation scripts. Installation documentation covers uv, pipx, pip, and conda-forge, with pip as the default installer for isolated builds and uv as an alternative. Backend settings can be passed with repeated -C options or --config-json. CI examples include GitHub Actions, GitLab CI, CircleCI, Travis CI, Azure Pipelines, Jenkins, Docker, and tox. Verified compatibility is listed for Python 3.10 through 3.14 and PyPy 3.10 and 3.11. Release attestations after 1.2.1 can be checked with the GitHub CLI.

Who it suits

build suits Python developers and automation teams that need a focused package-building frontend across Linux, macOS, Windows, or API workflows. It is less suited to projects seeking dependency, environment, or publishing management.

Good to know, and what to watch

  • Free and open source
  • Temporary isolated builds by default
  • PEP 517 backend support
  • Python API for automation
  • Examples for major CI systems
  • Does not manage dependencies
  • Does not manage virtual environments
  • No lockfile support
  • Not a package publishing tool

The verdict

build keeps Python package creation separate from dependency and environment management. Its isolation, backend compatibility, API, and CI examples make it practical for scripted build workflows.

What the maker publishes

Attestations
The installation guide says attestations are available for releases after 1.2.1 and can be verified with the GitHub CLI. source
Backend compatibility
It invokes standardized PEP 517 build backend hooks and supports backends beyond setuptools. source
Backend support
build uses standardized PEP 517 hooks to communicate with build backends. source
Build isolation
By default, it creates a temporary isolated virtual environment and installs the build backend and its dependencies there. source
CI integrations
The CI/CD guide includes setup examples for GitHub Actions, GitLab CI, CircleCI, Travis CI, Azure Pipelines, and Jenkins. source
Compatibility
The installation guide lists verified compatibility with Python 3.10 through 3.14 and PyPy 3.10 and 3.11. source
Compatibility
The guide lists compatibility with Python 3.10 through 3.14 and PyPy 3.10 and 3.11. source
Configurable installers
pip is the default installer for isolated builds, and uv is also supported as an installer. source
Configuration
It supports backend configuration through repeated -C options or --config-json for complex settings. source
Install options
The installation guide lists uv, pipx, and pip as installation options, and also documents conda-forge installation. source
Install options
The official guide recommends installation with uv and also documents pip and pipx. source
Integrations
The CI/CD guide gives examples for GitHub Actions, GitLab CI, CircleCI, Travis CI, Azure Pipelines, Jenkins, Docker, and tox. source
Isolation
Builds use a temporary isolated virtual environment by default, and the environment is removed after the build. source
Limit
For native wheels across multiple platforms and Python versions, the guide recommends cibuildwheel, which can call a build frontend such as build. source
Maintainer
The documentation copyright line names Filipe Laíns. source
Optional extras
Optional virtualenv and uv extras support alternative isolation and installer setups. source
Outputs
By default, build creates a source distribution and builds a wheel from it. source
Outputs
By default, it builds a source distribution and a wheel in the dist/ directory. source
Private indexes
It can use private package indexes through pip environment variables, and the guide warns that extra indexes can allow package shadowing. source
Product
build is a simple Python packaging frontend that reads pyproject.toml and invokes build backends to create distribution packages. source
Purpose
build is a Python packaging frontend that reads pyproject.toml and invokes build backends to create distribution packages. source
Python API
The product provides a Python API for programmatic use in build tools, CI systems, and automation scripts. source
Scope
It focuses on building packages and does not manage dependencies or virtual environments. source
Scope
It focuses on building packages and does not manage dependencies or virtual environments. source

Checked against the maker's pages on 9 Oct 2026.