Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Official repository for gevent-socketio
JavaScript Python Other



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.

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 and questions happen on the mailing list:

or in the Github issue tracking:

You can also contact the maintainer:


You can install with standard Python methods:

pip install gevent-socketio

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
Something went wrong with that request. Please try again.