Skip to main content

SocketIO server based on the Gevent pywsgi server, a Python network library

Project description


What you see here is a post-0.3.6 Git version of gevent-socketio maintained by Sebastian Pipping (@hartwork) branded gevent-socketio-hartwork for distinction on PyPI.

The idea is to deviate from upstream gevent-socketio as little as possible and mirror branch master unmodified. Maintenance is done on branch hartwork-master.

Over release 0.3.6, these notable commits are included, from most recent to oldest:

The remainder of this document is the original documentation, except with links adjusted. Enjoy.

Sebastian Pipping


gevent-socketio is a Python implementation of the Socket.IO protocol, developed originally for Node.js by LearnBoost and then ported to other languages. Socket.IO enables real-time web communications between a browser and a server, using a WebSocket-like API. One aim of this project is to provide a single gevent-based API that works across the different WSGI-based web frameworks out there (Pyramid, Pylons, Flask, web2py, Django, etc…). Only ~3 lines of code are required to tie-in gevent-socketio in your framework. Note: you need to use the gevent python WSGI server to use gevent-socketio.

Community, rise up!

ANNOUNCEMENT: This project is in need of a solid maintainer to navigate through the 27+ open Pull Requests, merge what needs to be merged, and continue on with newer developments. @abourget is not putting as much time as he’d like on this project these days. This project has nearly 1000 GitHub Stars.. it’s used by major corporations. It’s a great project for you to lead. Contact @abourget on Twitter @bourgetalexndre to take more leadership.

Technical overview

Most of the gevent-socketio implementation is pure Python. There is an obvious dependency on gevent, and another on gevent-websocket. There are integration examples for Pyramid, Flask, Django and BYOF (bring your own framework!).

Documentation and References

You can read the renderered Sphinx docs at:

Discussion happen in the Github issue tracking:

You can also contact the maintainer:


You can install with standard Python methods:

pip install gevent-socketio-hartwork

or from source:

git clone git://
cd gevent-socketio
python install

For development, run instead of install:

python develop

If you want to do all of that in a virtualenv, run:

virtualenv env
. env/bin/activate
python develop   # or install

To execute all tests, run:


To execute all tests for a specific Python version, run something like:

tox -e py27

To execute a specific test for a specific Python version, run something like:

tox -e py27 –

Project details

Download files

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

Files for gevent-socketio-hartwork, version 0.3.6.post201803091952
Filename, size File type Python version Upload date Hashes
Filename, size gevent_socketio_hartwork-0.3.6.post201803091952-py2-none-any.whl (35.8 kB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size gevent_socketio_hartwork-0.3.6.post201803091952-py3-none-any.whl (35.8 kB) File type Wheel Python version 3.6 Upload date Hashes View
Filename, size gevent-socketio-hartwork-0.3.6.post201803091952.tar.gz (2.4 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page