# ERROR: Exception:
Traceback (most recent call last):
  ...
pip._vendor.urllib3.exceptions.ReadTimeoutError: HTTPSConnectionPool(host='files.pythonhosted.org', port=443): Read timed out.

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

## Root Cause

The network connection to files.pythonhosted.org is too slow or unstable, so pip's default read timeout elapses before a wheel finishes downloading.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 3.x | active | — | — |

## Workarounds

1. **** (90% success)
   ```
   Run pip install --timeout 120 <pkg>, or set PIP_DEFAULT_TIMEOUT=120 in the environment.
   ```
2. **** (93% success)
   ```
   Run pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <pkg> (or another regional mirror).
   ```
3. **** (88% success)
   ```
   Use curl -O https://files.pythonhosted.org/.../pkg.whl then pip install ./pkg.whl.
   ```

## Dead Ends

- **** — Retries help with transient failures but do not extend the per-read timeout. (70% fail)
- **** — Cache is unrelated to network timeout. (90% fail)
- **** — Prereleases do not fix network latency. (95% fail)