Niquests HTTP Library

3.18.5 · active · verified Sat Apr 11

Niquests is a simple, yet elegant, HTTP library designed as a drop-in replacement for Requests, which is currently under feature freeze. It aims to extend Requests' capabilities with modern features like async support, ASGI/WSGI integration, and experimental WebAssembly compatibility. The current version is 3.18.5, and it maintains an active release cadence with frequent updates.

Warnings

gotcha While Niquests is a drop-in replacement for Requests, subtle behavioral differences may exist. For instance, the default `keepalive_delay` was lowered from 1 hour to 10 minutes in v3.18.3, which can affect long-lived connections.
Fix: Review Niquests' release notes and documentation for specific behavioral changes. Adjust `Session` parameters like `keepalive_delay` if needed to match previous Requests' behavior.
gotcha Compatibility issues for `isinstance` checks relying on `niquests.packages` were present in earlier versions, leading to potential type-checking failures. This was fixed in v3.18.4, but suggests reliance on internal `requests`-like structure can be brittle.
Fix: Upgrade to Niquests v3.18.4 or later to ensure correct type behavior and compatibility with code expecting Requests' internal structure.
gotcha Experimental features like WebAssembly (WASM) support introduced in v3.18.0 require specific environments (e.g., Chrome v137+, Firefox v131+, Node v22+) and often require enabling JavaScript Promise Integration (JSPI) explicitly.
Fix: Consult Niquests' documentation for WASM environment setup and ensure all prerequisites, including JSPI, are met for successful execution in WebAssembly contexts. Treat as experimental functionality.
gotcha Advanced features such as the `rtls` alternative TLS backend (v3.18.3) or native `http+unix` connections (v3.17.0) may require additional `pip install` dependencies or specific environmental configurations beyond the basic `niquests` install.
Fix: Refer to Niquests' documentation for detailed installation instructions and dependency requirements for specific advanced features.

Install

pip install niquests Install Niquests

Imports

get
```
import niquests
response = niquests.get('https://httpbin.org/get')
```
While Niquests is a drop-in replacement, directly using `niquests.get` ensures access to Niquests-specific features and avoids potential conflicts if `requests` is also installed.

post

import niquests
response = niquests.post('https://httpbin.org/post', json={'key': 'value'})

Similar to `get`, direct import of `niquests` is recommended for new code.

Session
```
from niquests import Session
session = Session()
```
Instantiate Niquests' `Session` object directly to utilize its enhanced features and thread-safety.
AsyncSession
```
from niquests import AsyncSession
async_session = AsyncSession()
```
Use `AsyncSession` for asynchronous operations, which requires an `anyio` backend to be installed.

Quickstart

This quickstart demonstrates both synchronous and asynchronous HTTP requests using Niquests. It performs a simple GET request using the top-level API and a POST request using an `AsyncSession` for concurrent operations.

import niquests
import asyncio

def sync_example():
    print('--- Sync Example ---')
    response = niquests.get('https://httpbin.org/get')
    response.raise_for_status()
    print(f"Sync GET status: {response.status_code}")
    print(f"Sync GET JSON: {response.json()['headers']['Host']}")

async def async_example():
    print('\n--- Async Example ---')
    async with niquests.AsyncSession() as session:
        response = await session.post('https://httpbin.org/post', json={'test': 'data'})
        response.raise_for_status()
        print(f"Async POST status: {response.status_code}")
        print(f"Async POST JSON: {response.json()['json']}")

if __name__ == '__main__':
    sync_example()
    asyncio.run(async_example())

view raw JSON →