# ERROR: WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ReadTimeoutError': HTTPSConnectionPool(host='pypi.org', port=443): Read timed out.

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

## Root Cause

Network latency or server slowness causes pip to exceed the default read timeout.

## Version Compatibility

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

## Workarounds

1. **Increase the default timeout using pip's option** (90% success)
   ```
   pip install --default-timeout=100 mypackage
   ```
2. **Use a faster mirror or proxy** (85% success)
   ```
   pip install -i https://pypi.douban.com/simple mypackage
   ```

## Dead Ends

- **Reducing the timeout value** — A shorter timeout will make the problem worse. (80% fail)
- **Using --no-cache-dir** — Caching is not related to network timeout. (70% fail)