NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #5143 most downloaded on PyPI
Advanced Python HTTP Client.
Latest stable
2.0.0
Last release 1 months ago
10 Oct 2026
Ships unpredictably
gaps range from 2 weeks to 2.7 years
Some releases are documented
notes for 12 of 26 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
26 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
Several of those fixes change behaviour, so read Breaking changes before upgrading.
First release since 1.0.1. The native library goes from bogdanfinn/tls-client v1.7.2 to v1.16.0, every platform gets its own wheel, and requests and responses now behave much more like requests. Several of those fixes change behaviour, so read Breaking changes before upgrading.
TLSClientExeption is renamed to TLSClientException.client_identifier raises ValueError and suggests close matches. Before, the native library silently fell back to its default profile. Some names in the old README never existed (chrome109, Chrome110, chrome111, chrome112, firefox108, Firefox110, safari_15_3). confirmed_android_2 is gone because upstream removed it.response.content is the exact bytes the server sent. Before, it was the library's UTF-8 text encoded again, which corrupted binary bodies.response.text is read-only. It is decoded from content using the charset in Content-Type, or UTF-8 when there is none. HTML <meta charset> is no longer read. For those pages, set the encoding before reading text:r.encoding = "iso-8859-1"
r.text
session.headers no longer picks up a Content-Type after a json= or data= request. If you relied on that, set the header yourself.session.cookies. The native library's cookie jar is off.
session.cookies is no longer sent." from them.requests does it.
TooManyRedirects is raised.Authorization and any Cookie header you passed are dropped when the redirect goes to another origin.response.cookies holds the cookies from every hop.allow_redirects still defaults to False.timeout or insecure_skip_verify values use separate native sessions, so they don't share connections.UnsupportedPlatformError. Before, they loaded a library built for the wrong platform. musl (Alpine) and ARMv6 (Raspberry Pi 1 and Zero) are not supported.additional_decode has no effect any more because upstream removed the feature. The argument is still accepted.Response() you build yourself starts with empty values instead of None.async with tls_client.AsyncSession(client_identifier="chrome_120") as session:
r = await session.get("https://example.com")
session.post(url, files={"file": open("report.pdf", "rb")}, data={"name": "report"})
AsyncSession for asyncio. It takes the same arguments as Session, plus executor=.files= sends multipart uploads, with the same forms requests accepts.timeout= takes seconds as an int or a float, so fractions of a second work. timeout_seconds= still works.header_order= can be set per request.response.history, response.encoding, and tls_client.exceptions.TooManyRedirects are new.alpn_protocols and alps_protocols for custom TLS clients, which now produce the requested fingerprint.chrome_144 to chrome_152, brave_146, firefox_147, firefox_148, safari_ios_18_5, safari_ios_26_0 and cloudscraper.py.typed, its type hints pass mypy strict, and it has no runtime dependencies.Content-Type no longer sticks to the session (#117).fork() (#101).params on a URL that already has a query string gives ?a=1&b=2 instead of ?a=1?b=2. params={} no longer adds a bare ?.session.params is sent with every request.timeout and insecure_skip_verify now take effect."https" entry is used.jar["name"] works for cookies with empty values, and multiple_domains() gives the right answer.Set-Cookie without a value no longer breaks the next request.Each wheel contains only the native library for its platform:
| OS | Architectures |
|---|---|
| macOS | x86_64, arm64 |
| Linux (glibc, manylinux_2_17) | x86_64, i686, aarch64, armv7l |
| Windows | 32-bit, 64-bit |
The sdist doesn't contain a native library.
Thanks to @HarshRajSinghania, @biggie0344 and @rl1987.
Full changelog: https://github.com/FlorianREGAZ/Python-Tls-Client/compare/1.0.1...2.0.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Added certificate pinning (by @biggie0344)
added close function to close the session and avoid memory leaking
close function to close the session and avoid memory leakingNothing published for this version
Improved the way headers are selected between session and request headers
Nothing published for this version
Updated shared libraries (added new features coming with them)
fixed sending form data
- Updated share libraries - Added aarch64 support
aarch64 supportNothing published for this version
Added _random tls extension order_ feature (Example here)
Added chrome_107 preset
chrome_107 presetFixed cookie handling
Nothing published for this version
Nothing published for this version
Adapted library to newest version of tls-client
url property to response, which displays where the response is coming fromchrome_106 presetNothing published for this version
- Fixed proxy handling - General improvements
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.