# error: invalid command 'bdist_wheel'

- **ID:** `python/pip-legacy-setup-py-bdist-wheel-failed`
- **Domain:** python
- **Category:** install_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

The build backend (setuptools) is missing the `wheel` package, which provides the bdist_wheel command used when building legacy setup.py projects under PEP 517.

## Version Compatibility

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

## Workarounds

1. **** (97% success)
   ```
   python -m pip install --upgrade pip setuptools wheel
   ```
2. **** (90% success)
   ```
   python -m pip install wheel
python -m pip install --no-build-isolation .
   ```

## Dead Ends

- **** — Upgrading setuptools does not install wheel; bdist_wheel is still missing. (70% fail)
- **** — Disabling build isolation uses the current env, which also lacks wheel, so the same error occurs. (60% fail)
- **** — bdist_wheel is invoked by pip's build backend, not by setup.py directly; edits don't help. (90% fail)