Webrockets 🚀

A high-performance WebSocket server for Python, with first-class Django support. The core server is implemented in Rust using PyO3 for maximum performance.

Features

High-performance - Rust-powered WebSocket server using axum and fastwebsockets
Django Integration - Built-in authentication classes and management commands
Pattern Matching - Route messages based on discriminator fields with optional Pydantic validation
Broadcasting - Built-in support for Redis and RabbitMQ message brokers
Async Ready - Supports both sync and async Python callbacks
Built-in Client - Sync and async WebSocket client with TLS, timeouts, and subprotocol negotiation

Performance

webrockets significantly outperforms other Python WebSocket implementations thanks to its Rust-powered core.

Benchmark: 100 connections, 20 byte messages

In a simple echo benchmark with 100 concurrent connections, webrockets achieves up to 10x higher throughput compared to Django Channels with Daphne. See the full benchmark results for detailed comparisons across different scenarios.

Benchmark machine: Thinkpad E16, Intel Core i7-1355U (12 cores), 16 GB RAM, EndeavourOS Linux (kernel 6.12.61-1-lts)

Installation

# Basic installation
pip install webrockets

# With Django integration
pip install webrockets[django]

# With Pydantic schema validation
pip install webrockets[schema]

# All extras
pip install webrockets[schema,django]

Quick Start

from webrockets import WebsocketServer

# Create a WebSocket server
server = WebsocketServer(host="0.0.0.0", port=8080)

# Create a route on the server
echo = server.create_route("ws/echo/", "echo")

@echo.connect("before")
def on_connect(conn):
    print(f"Client connected: {conn.path}")

@echo.receive
def on_message(conn, data):
    # Echo the message back
    conn.send(f"You said: {data}")

@echo.disconnect
def on_disconnect(conn, code=None, reason=None):
    print(f"Client disconnected: {code}")

server.start()

Django Integration

webrockets provides seamless Django integration with built-in authentication support.

Setup

Add webrockets to your INSTALLED_APPS:

INSTALLED_APPS = [
    ...
    "webrockets",
]

Optionally configure the server in your settings:

WEBSOCKET_HOST = "0.0.0.0"  # default
WEBSOCKET_PORT = 46290      # default
WEBSOCKET_BROKER = None     # or {"type": "redis", "url": "redis://localhost:6379"}

Create your WebSocket routes in a websockets.py file in any of your Django apps:

# myapp/websockets.py
from webrockets.django import server
from webrockets.django.auth import SessionAuthentication

chat = server.create_route(
    "ws/chat/",
    "chat",
    authentication_classes=[SessionAuthentication()]
)

@chat.connect("before")
def on_connect(conn):
    print(f"User {conn.user} joined the chat")

@chat.receive
def on_message(conn, data):
    conn.send(f"{conn.user}: {data}")

@chat.disconnect
def on_disconnect(conn, code=None, reason=None):
    print(f"User {conn.user} left the chat")

Start the WebSocket server:

python manage.py runwebsockets

Authentication Classes

webrockets includes several authentication classes following Django REST Framework patterns:

from webrockets.django import server
from webrockets.django.auth import (
    SessionAuthentication,       # Django session-based auth
    CookieTokenAuthentication,   # Token from cookie
    HeaderTokenAuthentication,   # Token from header
    QueryStringTokenAuthentication,  # Token from URL query
)

# Use session auth (for browser clients)
chat = server.create_route("ws/chat/", "chat", authentication_classes=[
    SessionAuthentication()
])

# Custom token authentication
class MyTokenAuth(CookieTokenAuthentication):
    cookie_name = "ws_token"

    def validate_token(self, token):
        # Return user object or None
        return User.objects.filter(auth_token=token).first()

Pattern Matching

Route messages based on JSON fields using the Match class:

from pydantic import BaseModel
from webrockets import Match, WebsocketServer

class ChatMessage(BaseModel):
    type: str
    content: str
    room: str

server = WebsocketServer()
chat = server.create_route("ws/chat/", "chat")

# Match on a single key/value with Pydantic validation
@chat.receive(match=Match("type", "message"), schema=ChatMessage)
def on_chat(conn, data: ChatMessage):
    conn.broadcast([data.room], data.content)

# Match without schema - data is the raw JSON string
@chat.receive(match=Match("type", "ping"))
def on_ping(conn, data: str):
    conn.send('{"type": "pong"}')

# Fallback for unmatched messages
@chat.receive
def on_fallback(conn, data):
    conn.send("Unknown message type")

Download files

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

Source Distribution

webrockets-0.2.1.tar.gz (319.6 kB view details)

Uploaded Jul 23, 2026 Source

Built Distributions

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

webrockets-0.2.1-pp311-pypy311_pp73-musllinux_1_2_x86_64.whl (2.7 MB view details)

Uploaded Jul 23, 2026 PyPymusllinux: musl 1.2+ x86-64

webrockets-0.2.1-pp311-pypy311_pp73-musllinux_1_2_aarch64.whl (2.5 MB view details)

Uploaded Jul 23, 2026 PyPymusllinux: musl 1.2+ ARM64

webrockets-0.2.1-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.5 MB view details)

Uploaded Jul 23, 2026 PyPymanylinux: glibc 2.17+ x86-64

webrockets-0.2.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.4 MB view details)

Uploaded Jul 23, 2026 PyPymanylinux: glibc 2.17+ ARM64

webrockets-0.2.1-cp313-cp313-musllinux_1_2_x86_64.whl (2.7 MB view details)

Uploaded Jul 23, 2026 CPython 3.13musllinux: musl 1.2+ x86-64

webrockets-0.2.1-cp313-cp313-musllinux_1_2_aarch64.whl (2.5 MB view details)

Uploaded Jul 23, 2026 CPython 3.13musllinux: musl 1.2+ ARM64

webrockets-0.2.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.5 MB view details)

Uploaded Jul 23, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64

webrockets-0.2.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.4 MB view details)

Uploaded Jul 23, 2026 CPython 3.13manylinux: glibc 2.17+ ARM64

webrockets-0.2.1-cp312-cp312-win_amd64.whl (2.3 MB view details)

Uploaded Jul 23, 2026 CPython 3.12Windows x86-64

webrockets-0.2.1-cp312-cp312-win32.whl (2.0 MB view details)

Uploaded Jul 23, 2026 CPython 3.12Windows x86

webrockets-0.2.1-cp312-cp312-musllinux_1_2_x86_64.whl (2.7 MB view details)

Uploaded Jul 23, 2026 CPython 3.12musllinux: musl 1.2+ x86-64

webrockets-0.2.1-cp312-cp312-musllinux_1_2_aarch64.whl (2.5 MB view details)

Uploaded Jul 23, 2026 CPython 3.12musllinux: musl 1.2+ ARM64

webrockets-0.2.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.5 MB view details)

Uploaded Jul 23, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64

webrockets-0.2.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.4 MB view details)

Uploaded Jul 23, 2026 CPython 3.12manylinux: glibc 2.17+ ARM64

webrockets-0.2.1-cp312-cp312-macosx_11_0_arm64.whl (2.2 MB view details)

Uploaded Jul 23, 2026 CPython 3.12macOS 11.0+ ARM64

webrockets-0.2.1-cp311-cp311-musllinux_1_2_x86_64.whl (2.7 MB view details)

Uploaded Jul 23, 2026 CPython 3.11musllinux: musl 1.2+ x86-64

webrockets-0.2.1-cp311-cp311-musllinux_1_2_aarch64.whl (2.5 MB view details)

Uploaded Jul 23, 2026 CPython 3.11musllinux: musl 1.2+ ARM64

webrockets-0.2.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.5 MB view details)

Uploaded Jul 23, 2026 CPython 3.11manylinux: glibc 2.17+ x86-64

webrockets-0.2.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.4 MB view details)

Uploaded Jul 23, 2026 CPython 3.11manylinux: glibc 2.17+ ARM64

webrockets-0.2.1-cp310-cp310-musllinux_1_2_x86_64.whl (2.7 MB view details)

Uploaded Jul 23, 2026 CPython 3.10musllinux: musl 1.2+ x86-64

webrockets-0.2.1-cp310-cp310-musllinux_1_2_aarch64.whl (2.5 MB view details)

Uploaded Jul 23, 2026 CPython 3.10musllinux: musl 1.2+ ARM64

webrockets-0.2.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.5 MB view details)

Uploaded Jul 23, 2026 CPython 3.10manylinux: glibc 2.17+ x86-64

webrockets-0.2.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.4 MB view details)

Uploaded Jul 23, 2026 CPython 3.10manylinux: glibc 2.17+ ARM64

webrockets-0.2.1-cp39-cp39-musllinux_1_2_x86_64.whl (2.7 MB view details)

Uploaded Jul 23, 2026 CPython 3.9musllinux: musl 1.2+ x86-64

webrockets-0.2.1-cp39-cp39-musllinux_1_2_aarch64.whl (2.5 MB view details)

Uploaded Jul 23, 2026 CPython 3.9musllinux: musl 1.2+ ARM64

webrockets-0.2.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.5 MB view details)

Uploaded Jul 23, 2026 CPython 3.9manylinux: glibc 2.17+ x86-64

webrockets-0.2.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.4 MB view details)

Uploaded Jul 23, 2026 CPython 3.9manylinux: glibc 2.17+ ARM64

File details

Details for the file webrockets-0.2.1.tar.gz.

File metadata

Download URL: webrockets-0.2.1.tar.gz
Upload date: Jul 23, 2026
Size: 319.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for webrockets-0.2.1.tar.gz
Algorithm	Hash digest
SHA256	`832a46b4dc468aea479e173cd5dc9a38fae84251633e261b049cec2cce541561`
MD5	`d185cc153a4ffe542b59298ca67a4c65`
BLAKE2b-256	`b52d5a1d535475f1b840bffae2e0c57c778620ba056fa87b0484ab12a4872b1c`

Algorithm	Hash digest
SHA256	`a4b11ecd144d90df8cff534fc1932c8758ccde343b171eea16d07974cd3b3a5b`
MD5	`9703b56f64656b6fb7137ece89d7530e`
BLAKE2b-256	`a01f66393243f896a283a7a3a4ea832955c5cd45f2169dc3942d6a9627ba65d9`

Algorithm	Hash digest
SHA256	`60708ce28725edb5bd245f0226b9083ed3e1741b48a55a781bb7a673cf8d7d7b`
MD5	`1860b8f923c638a8d7df9fe047e548ed`
BLAKE2b-256	`20414d3e60170eac891d4ab312fc8379e246fd439543de5ab14385478897b52b`

Algorithm	Hash digest
SHA256	`97d5fa9bbd5633577a89613292369f6073c209016b1b393b435b6659a953dfaa`
MD5	`28bd596161a8bb3267fbf8e8f17fc271`
BLAKE2b-256	`edbaa75008232168902edca12f2508944938dff610021fc76648f791e968f35b`

Algorithm	Hash digest
SHA256	`d37e53dd9597c53ce5f4be526e1d016cf8365a5f41a992ac2078b32b5e7f32cb`
MD5	`70fe7b2f9cfc9b941d1345469f20ef64`
BLAKE2b-256	`8a8ffca57e26c8447b6d442718a5f6ac3df7097d0d350b6688881a0fe78c3076`

Algorithm	Hash digest
SHA256	`d91494c61688efbae33ce6257a711206dbdee991551dbd85520580c5fa0f7257`
MD5	`516ea251373f84f30fc22e97c0a95dc4`
BLAKE2b-256	`db7a5bed708dd0ba4cd897ecb30b1f540938811ae2da73c98c1721591d0116b1`

Algorithm	Hash digest
SHA256	`335805db6b1ea1442fd0290818c2db59214303a00ff24ca58725244981e033e9`
MD5	`f8ea01431183ac9aa59861f4c8020456`
BLAKE2b-256	`20f312a3e7ab08d9199e1504845c68ff1a8eb2bfc35a7054032e6ff56be1c54b`

Algorithm	Hash digest
SHA256	`719d6bb14c9c2865bb481ab60aa83c7931144ec7400d4671091198f106567a38`
MD5	`0903398313faa5c98eb8a7c306cc08d3`
BLAKE2b-256	`36af5cc30e513340c87ebba70e843b09154a1ff4a28ab0d41856c9bfe935cb95`

Algorithm	Hash digest
SHA256	`6f11ff3721f2aaa05bf9c4694c4d48e67aeedd34dbd742a3f507541adcaa1cd6`
MD5	`a9abef262181f4affb39d729a561d177`
BLAKE2b-256	`e86b6b2736cbd4e852cbc2a69c25950013db5938b654ab01fc6641c100303981`

Algorithm	Hash digest
SHA256	`6b9df9959aabcff4238c62c0eeb29f95e41576fb9a7a574e8116011915df6085`
MD5	`cbe7c1b510b82bb068393560f6c33f40`
BLAKE2b-256	`3a16d799f98951084cba943a9d3b74e397b7f2939bbb8c427ce7caa419f7f770`

Algorithm	Hash digest
SHA256	`490ba0c4f0a1ea94026c53ec333ee26c0e23a3eac15626a85dc8a9249cb391da`
MD5	`cc32de828d5be1f27565c8b5a38eae07`
BLAKE2b-256	`8efe03fa263e6c8aee1ae83aca182f1e0c843d226ca881681990282a60e34f4b`

Algorithm	Hash digest
SHA256	`4d8115c64a2fb8080d14ac3f2aff0fd3c62b70faf6cfb340f12f0f035571544f`
MD5	`4b14565666b067d71f53fba0788dd5bf`
BLAKE2b-256	`bc81e7c0599f001ab652398faedfe5e0191b9ed4fb477de4c3d9afeb2d369318`

Algorithm	Hash digest
SHA256	`28311c87d9a5a9148f8fefdc089407af18033ab0ec9c779c3d8a52f4c098e3ab`
MD5	`5b45ed6ae41a0db324b110d771a8800e`
BLAKE2b-256	`de125f516968e61197f4919c9743e4c5eb143c7750c1e681accd1a34637cd7b5`

Algorithm	Hash digest
SHA256	`48a28984c3568d45831b5033d9818b57d0a81fce43bf693fc00030bf9a4ef2aa`
MD5	`8fe2dc99ffb526e5b99a656ad00ee6e4`
BLAKE2b-256	`31ccbe520950bdc04a3d489db37f38209434e2056ee1bbc16657269e7d3ffee4`

Algorithm	Hash digest
SHA256	`bf7553f97d13412b30eef111f560d9b38fb1a26678b8f124036dd61253e3e25b`
MD5	`9b6f89afef7f66d0ec763ffb7aba1121`
BLAKE2b-256	`fc1c37387d31a783fe31133750af1e2314607194f7d0f491093e21504932e1f0`

Algorithm	Hash digest
SHA256	`0f1b0d4d5d64991af72eb2ab944fe4eb41f3d8b8ec770ae4efb0108133ac1b6b`
MD5	`c87c09fa0711c745c170b0f3dc05ec7d`
BLAKE2b-256	`7bd94c86d0347fb1a0a4a5937ba629603295db15ba8ac6a951f53e3b9cc486f2`

Algorithm	Hash digest
SHA256	`7914a9a1421550b12d9c073251467adac1b77f62990523dd45325ce8045c01ef`
MD5	`1e574c0ade414b322ddee8be3904290f`
BLAKE2b-256	`480fa9c277838d0ef4aa4bb1194dec4e34dc4dc0e95cb2f5bea9645d3673824e`

Algorithm	Hash digest
SHA256	`a6a12b7d866665137284f07ba678c1b8305d27aafd6fbe9d426b5223ee5baea9`
MD5	`f0df101d5d7eb350c751883c476f6f38`
BLAKE2b-256	`1e06a43a3a2610213d68a57eb06013a933a90520783ea5cfe1209bfaa46c9354`

Algorithm	Hash digest
SHA256	`f2c626f9fd4e3e428da341ba609d6ac0750d3f7c28791b11496099d3be1e730a`
MD5	`f01ceb1cb24607ed1e7ba91e45e425b4`
BLAKE2b-256	`9b221469c05af642fefd4b4d4e71e41e2971c9683c71a2205e095c3b131e2914`

Algorithm	Hash digest
SHA256	`d8135368d2194680f64a80903bddd237c2a7b6733c31515b45155f2966e8f3e9`
MD5	`c75fba133dfb4f6cb70726b9fda6ddfb`
BLAKE2b-256	`77096601e73c58889016300fb9328d69618101f1280db74ce71efa49c3f5b29a`

Algorithm	Hash digest
SHA256	`57e72ae9fe763885b000ad925342196047799a14202d5294969cc40e3b1d1e53`
MD5	`691ceb97fe86b4c76fe6ee8229a87b46`
BLAKE2b-256	`8de3ee4950f993a1617ef091831470db0d1dc6a3ed096648a7927b25e21ed5dc`

webrockets 0.2.1

Webrockets 🚀

Features

Performance

Installation

Quick Start

Django Integration

Setup

Authentication Classes

Pattern Matching

Key dates

1 maintainer

License expression

Requires

Provides Extra

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

Algorithm	Hash digest
SHA256	`713acb1ce512d34abc8c83b06b46869a6f20966c320572cf8b924a4c6ef9a57c`
MD5	`ec8af94870d699ac3dedaaae83ae5228`
BLAKE2b-256	`e97b9b222a4cf59b97830856bbc54e5b7ed3b8ba60f284c0c359099d0c668cd3`

Algorithm	Hash digest
SHA256	`d41b5147a02f8b09d3608bfb9c4c98a391a0e2e3badf893953e8b437037232d8`
MD5	`e6c4ec97a35326154b69a03731b7586c`
BLAKE2b-256	`f41a990cced5caaf0a3b4710b6a83fe42e5aa89a92a474ed774b92283453eff5`

Algorithm	Hash digest
SHA256	`ba66bcf8b304a44da7183c2201ce7216bafbe8335544a89b7f121a46b1ded173`
MD5	`37fdfd3d6d9f6d5ff71abe2994854db8`
BLAKE2b-256	`bda7d51b6277bd263bd9540d7be648addd495b9a5c24c97dee2cb3c19213115f`

Algorithm	Hash digest
SHA256	`775579e57dd11c0a803d8acd32774b5e608b38ff6a0b01a4cfe4ce41662c3518`
MD5	`645612350767f119dd656e61451dd710`
BLAKE2b-256	`bbde3d872af1f09cbf87d4c0077aa25592bcfb922481ca75872254ff531675f0`

Algorithm	Hash digest
SHA256	`a899c243e34f17165972b0e147943021c6f732c71c211877655edfd235361ee2`
MD5	`0c9eda49e5b64851a7f9833fb96a53f7`
BLAKE2b-256	`7acc4536ede7c2d745a2cf8e08f948bfb3e49d1e14c8994ac10035abebef3ade`

Algorithm	Hash digest
SHA256	`ce4c9cb48397b75c7c2ff723ff4f0354952495ced83c4a2953bcdbfcd518b819`
MD5	`ddfd3bc25d4ee4425362530041a1f1e0`
BLAKE2b-256	`fb71d6487a258bdf0a77018725dcb9eff28830809f99645cfaac549bf4ff868e`

Algorithm	Hash digest
SHA256	`2b64172c2c16ea0fe51a1ab827b172f618b3942fd9de7d78181bdf130a6a460a`
MD5	`be1f302bf2a4faf89c167747c9b3eb07`
BLAKE2b-256	`2c2828176d7a1e98de19a4b588e354764880fecbf95646fdc50cd5fdb97701aa`