build
build.pypa.io
- Free plan
- Windows
- macOS
- Linux
- API
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.