# error: invalid command 'bdist_wheel'

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

## Root Cause

The wheel package is missing from the build environment, so setuptools cannot register the bdist_wheel command when building a wheel.

## Version Compatibility

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

## Workarounds

1. **** (95% success)
   ```
   pip install --upgrade wheel setuptools
python setup.py bdist_wheel
   ```
2. **** (95% success)
   ```
   pip install build
python -m build
# produces dist/*.whl and dist/*.tar.gz
   ```

## Dead Ends

- **** — wheel is a separate distribution; upgrading setuptools alone does not provide bdist_wheel. (85% fail)
- **** — Installs in legacy mode without producing a wheel; also deprecated and may fail on 3.12. (70% fail)