urllib3

PyPI Version Python Versions Join our Discord Coverage Status Build Status on GitHub Documentation Status
OpenSSF Scorecard SLSA 3 CII Best Practices

urllib3 is a powerful, user-friendly HTTP client for Python. urllib3 brings many critical features that are missing from the Python standard libraries:

  • Thread safety.
  • Connection pooling.
  • Client-side SSL/TLS verification.
  • File uploads with multipart encoding.
  • Helpers for retrying requests and dealing with HTTP redirects.
  • Support for gzip, deflate, brotli, and zstd encoding.
  • Proxy support for HTTP and SOCKS.
  • 100% test coverage.

... and many more features, but most importantly: Our maintainers have a 15+ year track record of maintaining urllib3 with the highest code standards and attention to security and safety.

Much of the Python ecosystem already uses urllib3 and you should too.

Installing

urllib3 can be installed with pip:

$ python -m pip install urllib3

Alternatively, you can grab the latest source code from GitHub:

$ git clone https://github.com/urllib3/urllib3.git
$ cd urllib3
$ pip install .

Getting Started

urllib3 is easy to use:

>>> import urllib3
>>> resp = urllib3.request("GET", "http://httpbin.org/robots.txt")
>>> resp.status
200
>>> resp.data
b"User-agent: *\nDisallow: /deny\n"

urllib3 has usage and reference documentation at urllib3.readthedocs.io.

Community

urllib3 has a community Discord channel for asking questions and collaborating with other contributors. Drop by and say hello 👋

Contributing

urllib3 welcomes contributions. Please read our contributing documentation before starting work.

Check for existing pull requests addressing the same issue, and share feedback and suggestions in the existing pull request and issue. Duplicate pull requests, including alternative solutions, will be rejected without review unless a maintainer has approved opening an alternative pull request in advance.

Security Disclosures

To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure with maintainers.

See the repository Security Policy for more details.

Maintainers

Meet our maintainers since 2008:

👋

Sponsorship

If your company benefits from this library, please consider sponsoring its development.

For Enterprise

Professional support for urllib3 is available as part of the Tidelift Subscription. Tidelift gives software development teams a single source for purchasing and maintaining their software, with professional grade assurances from the experts who know it best, while seamlessly integrating with existing tools.

Project links

Data verified by PyPI on Sep 15, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

3 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for illia-v from gravatar.com illia-v Avatar for SethMichaelLarson from gravatar.com SethMichaelLarson Avatar for shazow from gravatar.com shazow

Credits

PyPI data
Data sourced directly from PyPI's database.

Maintainer: Seth Michael Larson

Author: Andrey Petrov

GitHub Statistics

Data verified by PyPI on Sep 15, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Provides Extra

brotli h2 socks zstd

Tags

filepost http httplib https pooling ssl threadsafe urllib

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

urllib3-2.8.0.tar.gz (459.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

urllib3-2.8.0-py3-none-any.whl (135.7 kB view details)

Uploaded Python 3

File details

Details for the file urllib3-2.8.0.tar.gz.

File metadata

  • Download URL: urllib3-2.8.0.tar.gz
  • Upload date:
  • Size: 459.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for urllib3-2.8.0.tar.gz
Algorithm Hash digest
SHA256 63bf2ead4c879426ebf22ef2a781eeb4aa3b4ae798a0435506f8687fd5bb9b63
MD5 e8ed250b4d520f9e3c0df3165953aa94
BLAKE2b-256 e305b17359e1cefb4f909b5e40b1b90a496d987258916dbbf88e842c729f510e

See more details on using hashes here.

Provenance

The following attestation bundles were made for urllib3-2.8.0.tar.gz:

Publisher: publish.yml on urllib3/urllib3

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file urllib3-2.8.0-py3-none-any.whl.

File metadata

  • Download URL: urllib3-2.8.0-py3-none-any.whl
  • Upload date:
  • Size: 135.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for urllib3-2.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0cf3cae568d36aa9576b28dfb35f11328f1cb974ca7647d9475ebb86c75ac6e3
MD5 e6e9d40fb009e4a52290209506d8d4d4
BLAKE2b-256 929dc4e665119135114480843e7ab388fa94d8480650450e6f8e26b70d323a4c

See more details on using hashes here.

Provenance

The following attestation bundles were made for urllib3-2.8.0-py3-none-any.whl:

Publisher: publish.yml on urllib3/urllib3

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

2.8.0 This release

2 files

2.7.0

2 files

2.6.3

2 files

2.6.2

2 files

2.6.1

2 files

2.6.0

2 files

2.5.0

2 files

2.4.0

2 files

2.3.0

2 files

2.2.3

2 files

2.2.2

2 files

2.2.1

2 files

2.2.0

2 files

2.1.0

2 files

2.0.7

2 files

2.0.6

2 files

2.0.5

2 files

2.0.4

2 files

2.0.3

2 files

2.0.2

2 files

Yanked

2.0.1

2 files

Yanked reason: Truncated response bodies when streaming a large compressed body. Upgrade to at least 2.0.2 (See: https://github.com/urllib3/urllib3/issues/3009)

Yanked

2.0.0

2 files

Yanked reason: Truncated response bodies when streaming a large compressed body. Upgrade to at least 2.0.2 (See: https://github.com/urllib3/urllib3/issues/3009)

Pre-release

2.0.0a4

2 files

Pre-release

2.0.0a3

2 files

Pre-release

2.0.0a2

2 files

Pre-release

2.0.0a1

2 files

1.26.20

2 files

1.26.19

2 files

1.26.18

2 files

1.26.17

2 files

1.26.16

2 files

1.26.15

2 files

1.26.14

2 files

1.26.13

2 files

1.26.12

2 files

1.26.11

2 files

1.26.10

2 files

1.26.9

2 files

1.26.8

2 files

1.26.7

2 files

1.26.6

2 files

1.26.5

2 files

1.26.4

2 files

1.26.3

2 files

1.26.2

2 files

1.26.1

2 files

1.26.0

2 files

1.25.11

2 files

1.25.10

2 files

1.25.9

2 files

1.25.8

2 files

1.25.7

2 files

1.25.6

2 files

1.25.5

2 files

1.25.4

2 files

1.25.3

2 files

1.25.2

2 files

Yanked

1.25.1

2 files

Yanked reason: Broken release

Yanked

1.25

2 files

Yanked reason: Broken release

1.24.3

2 files

1.24.2

2 files

1.24.1

2 files

1.24

2 files

1.23

2 files

1.22

2 files

1.21.1

2 files

1.21

2 files

1.20

2 files

1.19.1

2 files

1.19

2 files

1.18.1

2 files

1.18

2 files

1.17

2 files

1.16

2 files

1.15.1

2 files

1.15

2 files

1.14

2 files

1.13.1

2 files

1.13

2 files

1.12

2 files

1.11

2 files

1.10.4

2 files

1.10.3

2 files

1.10.2

2 files

1.10.1

2 files

1.10

2 files

1.9.1

2 files

1.9

1 file

1.8.3

1 file

1.8.2

1 file

1.8

1 file

1.7.1

1 file

1.7

1 file

1.6

1 file

1.5

1 file

1.4

1 file

1.3

1 file

1.2.2

1 file

1.2.1

1 file

1.2

1 file

1.1

1 file

1.0.2

1 file

1.0.1

1 file

1.0

1 file

0.4.1

0.4.0

0.3.1

0.3

0.2

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page