build
build is a free, open-source Python packaging frontend that reads pyproject.toml and invokes build backends to create distribution packages.
What build is
build is a free, open-source Python packaging frontend that reads pyproject.toml and invokes build backends to create distribution packages. By default, it produces a source distribution and then builds a wheel from that source. Builds use a temporary isolated virtual environment where the backend and its dependencies are installed; the environment is removed afterward. The tool uses standardized PEP 517 hooks and can work with backends beyond setuptools. It focuses on package building and does not manage dependencies or virtual environments. A Python API supports build tools, CI systems, and automation scripts. Installation options include uv, pipx, pip, and conda-forge; pip is the default installer for isolated builds, with uv also supported. Backend settings can be supplied with repeated -C options or --config-json. Documentation provides CI examples for GitHub Actions, GitLab CI, CircleCI, Travis CI, Azure Pipelines, Jenkins, Docker, and tox. Verified compatibility includes Python 3.10 through 3.14 and PyPy 3.10 and 3.11.
Good
- Builds source distributions and wheels
- Uses standardized PEP 517 hooks
- Provides temporary isolated build environments
- Offers a Python API
- Includes many CI setup examples
Watch out
- Does not manage dependencies
- Does not manage virtual environments
- No lockfile support
- Native multi-platform wheels may require cibuildwheel
Who it suits
It suits Python developers who need a focused frontend for building source distributions and wheels. It also fits automation and CI workflows requiring isolated package builds.
Verdict
build provides a focused, standards-based way to create Python distribution artifacts with isolated builds. Teams must pair it with separate dependency, environment, or multi-platform wheel tooling when those needs arise.
The facts
Each one read from build's own pages, with the date it was checked.
What it does
- Attestations
- The installation guide says attestations are available for releases after 1.2.1 and can be verified with the GitHub CLI.checked 9 Oct 2026
- Backend compatibility
- It invokes standardized PEP 517 build backend hooks and supports backends beyond setuptools.checked 9 Oct 2026
- Backend support
- build uses standardized PEP 517 hooks to communicate with build backends.checked 8 Oct 2026
- Build isolation
- By default, it creates a temporary isolated virtual environment and installs the build backend and its dependencies there.checked 9 Oct 2026
- CI integrations
- The CI/CD guide includes setup examples for GitHub Actions, GitLab CI, CircleCI, Travis CI, Azure Pipelines, and Jenkins.checked 8 Oct 2026
- Compatibility
- The guide lists compatibility with Python 3.10 through 3.14 and PyPy 3.10 and 3.11.checked 9 Oct 2026
- Configurable installers
- pip is the default installer for isolated builds, and uv is also supported as an installer.checked 8 Oct 2026
- Configuration
- It supports backend configuration through repeated -C options or --config-json for complex settings.checked 9 Oct 2026
- Install options
- The official guide recommends installation with uv and also documents pip and pipx.checked 9 Oct 2026
- Integrations
- The CI/CD guide gives examples for GitHub Actions, GitLab CI, CircleCI, Travis CI, Azure Pipelines, Jenkins, Docker, and tox.checked 9 Oct 2026
- Isolation
- Builds use a temporary isolated virtual environment by default, and the environment is removed after the build.checked 8 Oct 2026
- Limit
- For native wheels across multiple platforms and Python versions, the guide recommends cibuildwheel, which can call a build frontend such as build.checked 8 Oct 2026
- Maintainer
- The documentation copyright line names Filipe Laíns.checked 9 Oct 2026
- Optional extras
- Optional virtualenv and uv extras support alternative isolation and installer setups.checked 9 Oct 2026
- Outputs
- By default, it builds a source distribution and a wheel in the dist/ directory.checked 9 Oct 2026
- Private indexes
- It can use private package indexes through pip environment variables, and the guide warns that extra indexes can allow package shadowing.checked 9 Oct 2026
- Product
- build is a simple Python packaging frontend that reads pyproject.toml and invokes build backends to create distribution packages.checked 9 Oct 2026
- Purpose
- build is a Python packaging frontend that reads pyproject.toml and invokes build backends to create distribution packages.checked 8 Oct 2026
- Python API
- The product provides a Python API for programmatic use in build tools, CI systems, and automation scripts.checked 8 Oct 2026
- Scope
- It focuses on building packages and does not manage dependencies or virtual environments.checked 9 Oct 2026
- Security
- The installation guide says attestations are available for releases after 1.2.1 and documents verification with the gh CLI.checked 8 Oct 2026
- Support
- The project documentation links to its GitHub issue tracker for reporting issues.checked 9 Oct 2026
