# ERROR: Could not build wheels for some-package, which is required to install pyproject.toml-based projects

- **ID:** `python/pip-build-isolation-missing-build-dependencies`
- **Domain:** python
- **Category:** install_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

pip attempted to build a wheel in an isolated environment but failed because the build dependencies specified in pyproject.toml are not available or cannot be installed, often due to network issues or missing system libraries.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 3.8 | active | — | — |
| 3.9 | active | — | — |
| 3.10 | active | — | — |
| 3.11 | active | — | — |
| 3.12 | active | — | — |

## Workarounds

1. **** (85% success)
   ```
   Install build dependencies manually: pip install build, then run python -m build to see detailed errors, and install missing system packages (e.g., libffi-dev, python3-dev).
   ```
2. **** (75% success)
   ```
   Use a pre-built wheel if available: pip install --only-binary :all: some-package.
   ```

## Dead Ends

- **** — Requires build dependencies to be already installed in the current environment; often they are not, leading to different errors. (70% fail)
- **** — Does not resolve missing system libraries or network issues. (80% fail)