# error: invalid command 'bdist_wheel'

- **ID:** `python/setuptools-install-command-invalid-command`
- **Domain:** python
- **Category:** install_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

The wheel package is not installed in the build environment. Modern setuptools no longer includes wheel support by default, so building a wheel distribution fails when the command is invoked.

## Version Compatibility

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

## Workarounds

1. **** (95% success)
   ```
   Install the wheel package: pip install wheel, then retry python setup.py bdist_wheel.
   ```
2. **** (98% success)
   ```
   Use python -m build (requires pip install build) which automatically installs wheel in an isolated environment.
   ```

## Dead Ends

- **** — Upgrading setuptools does not install the separate wheel package; the command remains unavailable. (90% fail)
- **** — setup.py install is deprecated and may still fail if wheel is needed for dependencies; it also doesn't produce a wheel. (60% fail)