gwebsocket is a WebSocket library for the gevent networking library.

from gevent import pywsgi
from gwebsocket.handler import WebSocketHandler

def websocket_app(environ, start_response):
    if environ["PATH_INFO"] == '/echo':
        ws = environ["wsgi.websocket"]
        message = ws.receive()

server = pywsgi.WSGIServer(("", 8000), websocket_app,


The easiest way to install gwebsocket is directly from PyPi using pip or setuptools by running the commands below:

$ pip install gwebsocket

Gunicorn Worker

Using Gunicorn it is even more easy to start a server. Only the websocket_app from the previous example is required to start the server. Start Gunicorn using the following command and worker class to enable WebSocket funtionality for the application.

gunicorn -k "gwebsocket.gunicorn.GWebSocketWorker" wsgi:websocket_app


gwebsocket is pretty fast, but can be accelerated further by installing wsaccel and ujson or simplejson:

$ pip install wsaccel ujson

gwebsocket automatically detects wsaccell and uses the Cython implementation for UTF8 validation and later also frame masking and demasking.

Get in touch

Issues can be created at Bitbucket.


gwebsocket is based on Jeffrey Gelens' `gevent-websocket`_. gwebsocket omits gevent-websocket's WAMP features and WebSocketApplication mini framework, in favor of providing just a minimal library for use in other frameworks. gwebsocket also makes it possible to do cleanup on close without building your app as a WebSocketApplication.