# ModuleNotFoundError: No module named 'uvloop'

- **ID:** `python/uvloop-install-failure`
- **Domain:** python
- **Category:** module_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

uvloop is not installed, or the wheel is unavailable for the current Python/platform combination (e.g. Windows, some Alpine builds), so import fails.

## Version Compatibility

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

## Workarounds

1. **** (90% success)
   ```
   Install with platform guards:

pip install 'uvloop; sys_platform != "win32"'
   ```
2. **** (85% success)
   ```
   Use winloop on Windows as a drop-in replacement:

if sys.platform == 'win32':
    import winloop as uvloop
   ```
3. **** (80% success)
   ```
   On Alpine, install build deps: apk add --no-cache python3-dev gcc musl-dev libffi-dev && pip install uvloop
   ```

## Dead Ends

- **** — Still fails on Windows and Alpine musl; no wheel exists. (75% fail)
- **** — Pre-releases rarely add platform support for musl/Windows. (80% fail)
- **** — Works but silently falls back to the default loop; performance assumptions may be wrong. (40% fail)