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

- **ID:** `python/pip-install-error-could-not-build-wheels`
- **Domain:** python
- **Category:** install_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

The package uses a pyproject.toml build system and pip failed to build a wheel, often due to missing build dependencies or compiler errors.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 3.x | active | — | — |

## Workarounds

1. **** (85% success)
   ```
   sudo apt-get install build-essential python3-dev
   ```
2. **** (80% success)
   ```
   pip install --upgrade pip setuptools wheel
   ```
3. **** (70% success)
   ```
   pip install package --only-binary :all:
   ```

## Dead Ends

- **** — This can help but often fails if build dependencies are not already installed. (60% fail)
- **** — The underlying build issue persists on retry. (90% fail)
- **** — Permissions are not the root cause; the build still fails. (95% fail)