# WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ConnectTimeoutError(<pip._vendor.urllib3.connection.HTTPSConnection object at 0x...>, 'Connection to pypi.org timed out. (connect timeout=15)')'

- **ID:** `python/pip-network-timeout`
- **Domain:** python
- **Category:** network_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

The network connection to PyPI is slow or blocked, causing the request to exceed the timeout.

## 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)
   ```
   pip install package --index-url https://mirrors.aliyun.com/pypi/simple/
   ```
2. **** (75% success)
   ```
   pip install package --timeout 60
   ```

## Dead Ends

- **** — Timeout increase may help temporarily but does not address underlying network issues like firewall or proxy. (50% fail)
- **** — Disabling cache does not affect network connectivity; timeout still occurs. (90% fail)