---
id: wsproto
version: "1.3.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# wsproto — Pure-Python WebSocket protocol implementation

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install wsproto
uv add wsproto
poetry add wsproto

## Description

========================================================
Pure Python, pure state-machine WebSocket implementation
========================================================

.. image:: https://github.com/python-hyper/wsproto/workflows/CI/badge.svg
    :target: https://github.com/python-hyper/wsproto/actions
    :alt: Build Status
.. image:: https://codecov.io/gh/python-hyper/wsproto/branch/main/graph/badge.svg
    :target: https://codecov.io/gh/python-hyper/wsproto
    :alt: Code Coverage
.. image:: https://readthedocs.org/projects/wsproto/badge/?version=latest
    :target: https://wsproto.readthedocs.io/en/latest/
    :alt: Documentation Status
.. image:: https://img.shields.io/badge/chat-join_now-brightgreen.svg
    :target: https://gitter.im/python-hyper/community
    :alt: Chat community


This repository contains a pure-Python implementation of a WebSocket protocol
stack. It's written from the ground up to be embeddable in whatever program you
choose to use, ensuring that you can communicate via WebSockets, as defined in
`RFC6455 <https://tools.ietf.org/html/rfc6455>`_, regardless of your programming
paradigm.

This repository does not provide a parsing layer, a network...

## AI interpretation — verify before relying

wsproto is a pure-Python, state-machine-based WebSocket protocol implementation that handles RFC 6455 WebSocket framing and RFC 7692 compression extensions without requiring network or concurrency layers.

Verdict: wsproto is a well-maintained, production-ready WebSocket protocol stack for Python 3.10+ with minimal dependencies, no known vulnerabilities, and permissive licensing. It's ideal for embedding WebSocket support into custom applications where you control the network and concurrency layers.

[View on SkillFed](https://skillfed.io/packages/wsproto) · [View on PyPI](https://pypi.org/project/wsproto/)