python-websockets/websockets
Websockets
websockets is a Python library that provides both client and server implementations for the WebSocket protocol, enabling real-time, bidirectional communication between applications. At its core, it offers the fundamental primitives for establishing persistent connections, managing their lifecycles, and exchanging text or binary messages asynchronously using coroutines.
The library distinguishes itself through comprehensive support for various messaging patterns, including broadcast messaging to all connected clients, targeted messaging to specific clients, and shared application state synchronization across multiple connections. It also includes a command-line interactive client for testing and debugging WebSocket endpoints directly from the terminal.
Beyond the core protocol implementation, websockets provides production deployment guidance across multiple platforms and environments, including Kubernetes, Fly.io, Heroku, and Koyeb, as well as configurations for reverse proxies like HAProxy and process managers like Supervisor. The documentation covers TLS setup, load balancing, and other production considerations for running WebSocket servers reliably.
Features
- WebSocket Servers - Provides a server-side implementation for starting a WebSocket listener and handling messages asynchronously using coroutines.
- Broadcast Messaging - Supports sending a message from the server to every currently connected WebSocket client simultaneously.
- Websocket Connection Managers - Handles WebSocket connection lifecycle including opening, closing, and error recovery to keep application code simple.
- Real-Time Connections - Establishes persistent bidirectional connections between servers and clients for real-time message exchange.
