Skip to main content

Niquests is a simple, yet elegant, HTTP library. It is a drop-in replacement for Requests, which is under feature freeze.

Project description

Niquests Logo

Niquests is a simple, yet elegant, HTTP library. It is a drop-in replacement for Requests, which is under feature freeze. โœจ Were you used to betamax, requests-mock, responses, ...? See how they still work! We got you covered.

Niquests, is the โ€œSafest, Fastest[^10], Easiest, and Most advancedโ€ Python HTTP Client. Production Ready!

Live Benchmark

Target: https://httpbingo.org/get
Conditions: All default parameters, one shared session, everything simultaneously.
HTTP/2 when supported.
Niquests Benchmark
๐Ÿ‘† Look at the feature table comparison against requests, httpx and aiohttp!
Feature niquests requests httpx aiohttp
HTTP/1.1 โœ… โœ… โœ… โœ…
HTTP/2 โœ… โŒ โœ…[^7] โŒ
HTTP/3 over QUIC โœ… โŒ โŒ โŒ
Synchronous โœ… โœ… โœ… N/A[^1]
Asynchronous โœ… โŒ โœ… โœ…
Thread Safe โœ… โœ… โŒ[^5] N/A[^1]
Task Safe โœ… N/A[^2] โœ… โœ…
OS Trust Store โœ… โŒ โŒ โŒ
Multiplexing โœ… โŒ Limited[^3] โŒ
DNSSEC โœ…[^11] โŒ โŒ โŒ
Customizable DNS Resolution โœ… โŒ โŒ โœ…
DNS over HTTPS โœ… โŒ โŒ โŒ
DNS over QUIC โœ… โŒ โŒ โŒ
DNS over TLS โœ… โŒ โŒ โŒ
Multiple DNS Resolver โœ… โŒ โŒ โŒ
Network Fine Tuning & Inspect โœ… โŒ Limited[^6] Limited[^6]
Certificate Revocation Protection โœ… โŒ โŒ โŒ
Session Persistence โœ… โœ… โœ… โœ…
In-memory Certificate CA & mTLS โœ… โŒ Limited[^4] Limited[^4]
SOCKS 4/5 Proxies โœ… โœ… โœ… โŒ
HTTP/HTTPS Proxies โœ… โœ… โœ… โœ…
TLS-in-TLS Support โœ… โœ… โœ… โœ…
Direct HTTP/3 Negotiation โœ…[^9] N/A[^8] N/A[^8] N/A[^8]
Happy Eyeballs โœ… โŒ โŒ โœ…
Package / SLSA Signed โœ… โŒ โŒ โœ…
HTTP/2 with prior knowledge (h2c) โœ… โŒ โœ… โŒ
Post-Quantum Security & ECH โœ… [^12] โŒ โŒ โŒ
HTTP Trailers โœ… โŒ โŒ โŒ
Early Responses โœ… โŒ โŒ โŒ
WebSocket over HTTP/1 โœ… โŒ[^14] โŒ[^14] โœ…
WebSocket over HTTP/2 and HTTP/3 โœ…[^13] โŒ โŒ โŒ
Automatic Ping for HTTP/2+ โœ… N/A โŒ N/A
Automatic Connection Upgrade / Downgrade โœ… N/A โŒ N/A
Server Side Event (SSE) โœ… โŒ โŒ โŒ
WASM / Pyodide โœ… โœ… โŒ โŒ
๐Ÿ“ˆ Look at the performance comparison against them!

Given the script hosted at https://gist.github.com/Ousret/9e99b07e66eec48ccea5811775ec116d that simply send 1000 requests. We deliberately use a real remote endpoint, disabled Niquests manual multiplexing (for fairness), to showcase how the client behave in a real life usage.

GET https://httpbingo.org/get

Client Average Delay to Complete Notes
httpx 2.087s HTTP/2
aiohttp 1.351s HTTP/1.1
niquests 0.551s HTTP/2

:tada: Niquests can easily bring you twice the throughput if you migrated today. Join us today!

>>> import niquests
>>> r = niquests.get('https://one.one.one.one')
>>> r.status_code
200
>>> r.headers['content-type']
'application/json; charset=utf-8'
>>> r.oheaders.content_type.charset
'utf-8'
>>> r.encoding
'utf-8'
>>> r.text
'{"authenticated": true, ...'
>>> r.json()
{'authenticated': True, ...}
>>> r
<Response HTTP/2 [200]>
>>> r.ocsp_verified
True
>>> r.conn_info.established_latency
datetime.timedelta(microseconds=38)

or using async/await!

import niquests
import asyncio

async def main() -> None:
    r = await niquests.aget('https://one.one.one.one', stream=True)
    print(r)  # Output: <Response HTTP/2 [200]>
    payload = await r.text  # we await text because we set `stream=True`!
    print(payload)  # Output: <html>...
    # or... without stream=True
    r = await niquests.aget('https://one.one.one.one')
    print(r)  # Output: <Response HTTP/3 [200]>
    payload = r.text  # we don't need to away anything, it's already loaded!
    print(payload)  # Output: <html>...

asyncio.run(main())

Niquests allows you to send HTTP requests extremely easily. Thereโ€™s no need to manually add query strings to your URLs, or to form-encode your PUT & POST data โ€” just use the json method!

PyPI Downloads Supported Versions OpenSSF Best Practices

This project does not require any compilation toolchain. The HTTP/3 support is not enforced and installed if your platform can support it natively (e.g. pre-built wheel available).

โœจ Installing Niquests and Supported Versions

Niquests is available on PyPI:

$ python -m pip install niquests

Niquests officially supports Python or PyPy 3.7+.

๐Ÿš€ Supported Features & Bestโ€“Practices

Niquests is ready for the demands of building scalable, robust and reliable HTTPโ€“speaking applications.

  • DNS over HTTPS, DNS over QUIC, DNS over TLS, and DNS over UDP
  • Automatic Content Decompression and Decoding
  • OS truststore by default, no more certifi!
  • OCSP Certificate Revocation Verification
  • Advanced connection timings inspection
  • In-memory certificates (CAs, and mTLS)
  • Browser-style TLS/SSL Verification
  • Certificate Revocation List (CRL)
  • Sessions with Cookie Persistence
  • Keep-Alive & Connection Pooling
  • International Domains and URLs
  • Automatic honoring of .netrc
  • Basic & Digest Authentication
  • Familiar dictโ€“like Cookies
  • Network settings fine-tuning
  • HTTP/2 with prior knowledge
  • Object-oriented headers
  • Multi-part File Uploads
  • Post-Quantum Security
  • Chunked HTTP Requests
  • Fully type-annotated!
  • Run in the Browser!
  • SOCKS Proxy Support
  • Connection Timeouts
  • Streaming Downloads
  • HTTP/2 by default
  • HTTP/3 over QUIC
  • Early Responses
  • Happy Eyeballs
  • Multiplexed!
  • Thread-safe!
  • WebSocket!
  • Trailers!
  • DNSSEC!
  • Async!
  • SSE!
  • ECH!

Need something more? Create an issue, we actively listen.

๐Ÿ“ Why did we pursue this?

For many years now, Requests has been frozen. Being left in a vegetative state and not evolving, this blocked millions of developers from using more advanced features.

We don't have to reinvent the wheel all over again, HTTP client Requests is well established and really pleasant in its usage. We believe that Requests has the most inclusive and developer friendly interfaces. We intend to keep it that way. As long as we can, long live Niquests!

How about a nice refresher with a mere CTRL+H import requests to import niquests as requests ?

๐Ÿ’ผ For Enterprise

Professional support for Niquests 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.

You may also be interested in unlocking specific advantages (like access to a private issue tracker) by looking at our GitHub sponsor tiers.


Niquests is a highly improved HTTP client that is based (forked) on Requests. The previous project original author is Kenneth Reitz and actually left the maintenance of Requests years ago.

[^1]: aiohttp was conceived solely for an asynchronous context. [^2]: requests has no support for asynchronous request. [^3]: while the HTTP/2 connection object can handle concurrent requests, you cannot leverage its true potential. [^4]: loading client certificate without file can't be done. [^5]: httpx officially claim to be thread safe but recent tests demonstrate otherwise as of March 2026. https://github.com/jawah/niquests/issues/83#issuecomment-1956065258 https://github.com/encode/httpx/issues/3072 https://github.com/encode/httpx/issues/3002 and only recently acknowledged the issue in https://github.com/encode/httpx/issues/3324 (one year after getting valid reports). [^6]: they do not expose anything to control network aspects such as IPv4/IPv6 toggles, and timings (e.g. DNS response time, established delay, TLS handshake delay, etc...) and such. [^7]: while advertised as possible, they refuse to make it the default due to performance and stability issues. as of December 2025 an extra is required to enable it manually. [^8]: they don't support HTTP/3 at all. [^9]: you must use a custom DNS resolver so that it can preemptively connect using HTTP/3 over QUIC when remote is compatible. [^10]: performance measured when leveraging a multiplexed connection with or without uses of any form of concurrency as of March 2026. The research compared httpx, requests, aiohttp against niquests. See https://gist.github.com/Ousret/9e99b07e66eec48ccea5811775ec116d [^11]: enabled when using a custom DNS resolver. [^12]: depends on your Python runtime. ECH and PQ support through HTTP/3 over QUIC requires qh3 installed. HTTP/1, and HTTP/2 can benefit from PQ and ECH, provided the rtls extra is installed. ECH requires you to use a custom resolver (e.g. DNS-over-HTTPS). [^13]: most servers out there are not ready for this feature, but Niquests is already compliant and future-proof! Caddy server and HAProxy support this! [^14]: they don't offer any built-in to speak with a WebSocket server.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

niquests-3.18.4.tar.gz (1.0 MB view details)

Uploaded Source

Built Distribution

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

niquests-3.18.4-py3-none-any.whl (208.6 kB view details)

Uploaded Python 3

File details

Details for the file niquests-3.18.4.tar.gz.

File metadata

  • Download URL: niquests-3.18.4.tar.gz
  • Upload date:
  • Size: 1.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for niquests-3.18.4.tar.gz
Algorithm Hash digest
SHA256 d2f672163c58ce9bc1922ac71c88c0f6b999878b7c642fe3ba8ded275dcbe2ec
MD5 f6ae8a44c0645abb4ce56b0b9d0a8c74
BLAKE2b-256 32820ecc7c940e64cb8cb292278c276a5e99a2591074c58ab04ebb7d25cb830f

See more details on using hashes here.

Provenance

The following attestation bundles were made for niquests-3.18.4.tar.gz:

Publisher: publish.yml on jawah/niquests

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

File details

Details for the file niquests-3.18.4-py3-none-any.whl.

File metadata

  • Download URL: niquests-3.18.4-py3-none-any.whl
  • Upload date:
  • Size: 208.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for niquests-3.18.4-py3-none-any.whl
Algorithm Hash digest
SHA256 4098d29516936f58d35c348abda23a632e21d1f38de78e60d68d013254c12f88
MD5 162468eefa9a7edf5c6bcf704d07ebba
BLAKE2b-256 18bc4de83b7e1be6eeec21267adc7e5385a0b3c7ca2631cf399f7fad59ffe0bd

See more details on using hashes here.

Provenance

The following attestation bundles were made for niquests-3.18.4-py3-none-any.whl:

Publisher: publish.yml on jawah/niquests

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

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page