pip network_error ai_generated partial

pip._vendor.urllib3.exceptions.ReadTimeoutError: HTTPSConnectionPool

ID: pip/read-timeout-error

Also available as: JSON · Markdown
82%Fix Rate
85%Confidence
50Evidence
2023-01-01First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
24 active — — —

Root Cause

PyPI download timed out. Slow network, large package, or PyPI issues.

generic

Workarounds

  1. 90% success Increase timeout: pip install --timeout 120 <package> 
    pip install --timeout 120

    Sources: https://pip.pypa.io/en/stable/cli/pip_install/#cmdoption-timeout

  2. 85% success Use a mirror: pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <package> 
    pip install -i https://pypi.tuna.tsinghua.edu.cn/simple

    Sources: https://pip.pypa.io/en/stable/cli/pip_install/#cmdoption-i

  3. 80% success Retry — PyPI may have temporary issues 
    pip install --retries 5 <package>

    Sources: https://pip.pypa.io/en/stable/cli/pip_install/

Dead Ends

Common approaches that don't work:

  1. Install from GitHub directly 65% fail

    GitHub is not a package registry — versions may not match PyPI

  2. Disable SSL to speed up 85% fail

    Security risk and usually doesn't help with timeouts

Error Chain

Frequently confused with: