# error: invalid command 'bdist_wheel'

- **ID:** `python/setuptools-command-not-found-bdist-wheel`
- **Domain:** python
- **Category:** install_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

The wheel package is not installed, so setuptools cannot find the bdist_wheel command. Modern build frontends (pip, build) install this automatically, but direct `python setup.py bdist_wheel` calls do not.

## Version Compatibility

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

## Workarounds

1. **** (97% success)
   ```
   pip install wheel && python setup.py bdist_wheel
   ```
2. **** (98% success)
   ```
   pip install build && python -m build
   ```

## Dead Ends

- **** — Deprecated and bypasses wheel building; produces a non-portable install. (60% fail)
- **** — setuptools does not bundle wheel; the wheel package must be installed separately. (90% fail)