miguelgrinberg/python-socketio

Mirror of https://code.miguelgrinberg.com/miguelgrinberg/python-socketio

Python

4,370

792 commits

updated Sep 14, 2026

See the code

README

python-socketio

tests

Python implementation of the Socket.IO realtime client and server.

Version compatibility

The Socket.IO protocol has been through a number of revisions, and some of these introduced backward incompatible changes, which means that the client and the server must use compatible versions for everything to work.

If you are using the Python client and server, the easiest way to ensure compatibility is to use the same version of this package for the client and the server. If you are using this package with a different client or server, then you must ensure the versions are compatible.

The version compatibility chart below maps versions of this package to versions of the JavaScript reference implementation and the versions of the Socket.IO and Engine.IO protocols.

JavaScript Socket.IO versionSocket.IO protocol revisionEngine.IO protocol revisionpython-socketio version
0.9.x1, 21, 2Not supported
1.x and 2.x3, 434.x
3.x and 4.x545.x

Resources

This project relies on contributions from its users. If you benefit from it please consider making a single or ongoing monetary contribution in one of the following platforms:

Thank you!

asyncio
eventlet
gevent
long-polling
low-latency
python
socket-io
socketio
socketio-server
web-server
websocket

miguelgrinberg/python-socketio

Mirror of https://code.miguelgrinberg.com/miguelgrinberg/python-socketio

Python

4,370

792 commits

updated Sep 14, 2026

See the code

README

python-socketio

tests

Python implementation of the Socket.IO realtime client and server.

Version compatibility

The Socket.IO protocol has been through a number of revisions, and some of these introduced backward incompatible changes, which means that the client and the server must use compatible versions for everything to work.

If you are using the Python client and server, the easiest way to ensure compatibility is to use the same version of this package for the client and the server. If you are using this package with a different client or server, then you must ensure the versions are compatible.

The version compatibility chart below maps versions of this package to versions of the JavaScript reference implementation and the versions of the Socket.IO and Engine.IO protocols.

JavaScript Socket.IO versionSocket.IO protocol revisionEngine.IO protocol revisionpython-socketio version
0.9.x1, 21, 2Not supported
1.x and 2.x3, 434.x
3.x and 4.x545.x

Resources

This project relies on contributions from its users. If you benefit from it please consider making a single or ongoing monetary contribution in one of the following platforms:

Thank you!

asyncio
eventlet
gevent
long-polling
low-latency
python
socket-io
socketio
socketio-server
web-server
websocket

Project health

Overall

4.5/10

Maintained

10/10

Code review

0/10
OpenSSF Scorecard

Latest release

5.17.0 · Sep 14, 2026

Releases this year

10

Significant stargazers

dgtlmoon

2,410 followers · starred Mar 2017

Adam Munawar Rahman

39 followers · starred Jul 2019

Xiang Zhang

270 followers · starred Mar 2017

Emmanuel Leblond

208 followers · starred May 2026