websocket-client

WebSocket client for Python with low level API options

websocket-client Permissive license Apache-2.0 Active ★ 3,711 v1.9.0 released 2025-10-07

Install

websocket-client on PyPI

pip

pip install websocket-client

uv

uv add websocket-client

poetry

poetry add websocket-client

Package facts

License	Apache-2.0 (permissive)
Python support	supports the current Python release (>=3.9)
Install friction	low — pure-Python wheel
Runtime dependencies	none
Maintenance	actively maintained — 310 days since the last release
Last repo commit	2026-05-04
First released	2011-01-04
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: websocket_client-1.9.0-py3-none-any.whl

Keywords: websockets, client

Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: WindowsOperating System :: POSIXProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.9Topic :: InternetTopic :: Software Development :: Libraries :: Python Modules

About websocket-client

from the package's own PyPI description — quoted content, verbatim

docs (image) Build Status (image) codecov (image) PyPI Downloads (image) PyPI version (image) License (image) Code style: black (image)

websocket-client

websocket-client is a WebSocket client for Python. It provides access to low level APIs for WebSockets. websocket-client implements version hybi-13 of the WebSocket...

Read as markdown · JSON record · Source repository · Homepage · Docs

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

websocket-client provides a Python WebSocket client implementing the hybi-13 protocol with low-level APIs for establishing and managing WebSocket connections, including automatic reconnection support via event callbacks.

Installs with zero runtime dependencies and ships as a pure-Python wheel. Actively maintained with recent commits and a 13-year release history; last release 310 days ago signals steady but not rushed development.

Apache-2.0 is permissive and imposes minimal restrictions; you may use, modify, and distribute this package freely in commercial and private projects provided you include a copy of the license.

Usage

pip install websocket-client

from websocket import create_connection
ws = create_connection("ws://echo.websocket.events/")
ws.send("Hello")
print(ws.recv())
ws.close()

Requires Python 3.9 or later; optional dependencies unlock proxy support, performance tuning, and automatic reconnection.

Verdict: A stable, dependency-free WebSocket client suitable for production use. Zero known vulnerabilities, permissive licensing, and active maintenance make it a low-risk choice. The 310-day gap since last release is normal for a mature library; the recent commit history confirms ongoing support.

Needs verification

Whether the hybi-13 protocol version and lack of RFC 7692 (permessage-deflate) compression support meet your application's interoperability requirements.
Real-world performance characteristics and whether optional wsaccel installation is necessary for your use case.

websocket client pythonws protocol implementationreal-time bidirectional communicationwebsocket connection managementevent-driven websocketlong-lived websocket connectionswebsocket reconnection