httpx-ws
WebSockets support for HTTPX
Decision gist · record as of 2026-08-14
Yes. httpx-ws is actively maintained, has low install friction, carries no known vulnerabilities, and is widely downloaded. It is the natural choice if you already use HTTPX and need WebSocket support. The Beta status reflects maturity rather than instability—it is suitable for production use.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later; asyncio or Trio runtime for async operations.
- Low install friction with a pure-Python wheel distribution.
- Actively maintained as of 2026-08-12 with recent releases; rated Beta status but in the top 5000 PyPI packages by download volume.
License · maintenance · safety
permissive license (permissive) — MIT license permits unrestricted use, modification, and distribution in both open-source and proprietary projects with minimal obligations.
last release 2026-03-28 (139 days) · last repo commit 2026-08-12 · 152 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 11,327,645 downloads/mo, #1,398 on PyPI
Alternatives
Verify before relying
pip install httpx-ws
import httpx
import httpx_ws
async with httpx.AsyncClient() as client:
async with httpx_ws.aconnect_ws('wss://example.com/ws', client=client) as ws:
await ws.send_text('Hello')
data = await ws.receive_text()- Whether automatic keepalive ping is configurable or always enabled by default.
- Performance characteristics under high-concurrency or high-throughput WebSocket scenarios.
- Compatibility with specific ASGI frameworks beyond the general ASGI transport testing claim.
What it is and what it does
httpx-ws extends HTTPX with WebSocket protocol support, allowing developers to establish and manage WebSocket connections using the same client interface they use for HTTP requests. It provides both synchronous and asynchronous APIs, with convenience methods for sending and receiving text, binary, or JSON payloads. The package handles protocol-level details such as automatic ping/pong responses and optional keepalive pings, and includes an HTTPX transport for testing WebSocket endpoints defined in ASGI applications.
The package builds on httpx, httpcore, anyio, and wsproto, supporting Python 3.10 through 3.14 and both asyncio and Trio async backends through anyio. It is actively maintained and widely used, though still in Beta status, making it suitable for production use cases where WebSocket support is needed alongside HTTP in a unified client.
Use it for
- Building real-time chat or notification clients that communicate over WebSockets while using HTTPX for initial authentication or REST calls.
- Testing ASGI-based WebSocket endpoints in unit tests using the HTTPX transport without spinning up a live server.
- Creating async applications that need to maintain long-lived WebSocket connections with automatic keepalive and ping/pong handling.
- Sending and receiving structured JSON data over WebSocket connections with minimal boilerplate.
- Migrating existing HTTPX-based clients to support bidirectional communication without switching HTTP libraries.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
httpx-ws is actively maintained, has low install friction, carries no known vulnerabilities, and is widely downloaded. It is the natural choice if you already use HTTPX and need WebSocket support. The Beta status reflects maturity rather than instability—it is suitable for production use.
Install
httpx-ws on PyPI
Before you install
Low install friction with a pure-Python wheel distribution. Actively maintained as of 2026-08-12 with recent releases; rated Beta status but in the top 5000 PyPI packages by download volume.
Requires Python 3.10 or later; asyncio or Trio runtime for async operations.
License in practice
MIT license permits unrestricted use, modification, and distribution in both open-source and proprietary projects with minimal obligations.
Quickstart
pip install httpx-ws
import httpx
import httpx_ws
async with httpx.AsyncClient() as client:
async with httpx_ws.aconnect_ws('wss://example.com/ws', client=client) as ws:
await ws.send_text('Hello')
data = await ws.receive_text()Verify before relying
- Whether automatic keepalive ping is configurable or always enabled by default.
- Performance characteristics under high-concurrency or high-throughput WebSocket scenarios.
- Compatibility with specific ASGI frameworks beyond the general ASGI transport testing claim.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 4 packagesanyiohttpcorehttpxwsproto |
| Maintenance | Actively maintained 139 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 11,327,645 / month, #1,398 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaFramework :: AsyncIOIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Internet :: WWW/HTTP :: Session |
Evidence: httpx_ws-0.9.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “httpx websocket support”
- httpx-wsAdds WebSocket support to HTTPX, enabling sync and async WebSocket…
- agentmailAgentmail provides a Python client library for accessing the…
- python-okxUnofficial Python wrapper for the OKX exchange v5 API, providing REST…
Give your agent the search over MCP, or paste the wish link into any chat.
More WWW/HTTP packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
HTTPX is a fully featured HTTP client library for Python that provides both sync and async APIs, with support for HTTP/1.1 and HTTP/2, plus an integrated command-line client.
Install it if you are building new projects or modernizing existing ones that rely on HTTP.
A minimal low-level HTTP client library that sends HTTP requests with thread-safe and task-safe connection pooling, supporting HTTP/1.1, HTTP/2, proxies, and both sync and async interfaces.
aiohttp is an async HTTP client and server framework built on asyncio, supporting both WebSockets and middleware-based routing for building concurrent web applications.
Install it if you need async HTTP client or server capabilities in asyncio-based applications.
See also httpx-oauth · websockets-proxy · bottle-websocket · websockets · aiosonic · httpx-socks · websocket-client · websockify · samsungtvws · aiohttp-asgi-connector