MCPcopy Index your code
hub / github.com/miguelgrinberg/python-socketio

github.com/miguelgrinberg/python-socketio @v5.16.3

Chat with this repo
repository ↗ · DeepWiki ↗ · release v5.16.3 ↗ · + Follow
1,399 symbols 5,286 edges 113 files 217 documented · 16% updated 16d agov5.16.3 · 2026-06-15★ 4,3679 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

python-socketio

Build status codecov

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

Sponsors

The following organizations are funding this project:

Socket.IO

Socket.IO Add your company here!

Many individual sponsors also support this project through small ongoing contributions. Why not join them?

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 version Socket.IO protocol revision Engine.IO protocol revision python-socketio version
0.9.x 1, 2 1, 2 Not supported
1.x and 2.x 3, 4 3 4.x
3.x and 4.x 5 4 5.x

Resources

Core symbols most depended-on inside this repo

emit
called by 179
src/socketio/client.py
encode
called by 178
src/socketio/packet.py
on
called by 160
src/socketio/base_client.py
is_connected
called by 89
src/socketio/base_manager.py
_handle_eio_message
called by 80
src/socketio/server.py
_handle_eio_message
called by 76
src/socketio/async_server.py
get
called by 69
examples/server/tornado/app.py
enter_room
called by 55
src/socketio/server.py

Shape

Method 1,143
Function 147
Class 87
Route 22

Languages

Python100%
TypeScript1%

Modules by API surface

tests/common/test_client.py116 symbols
tests/common/test_server.py106 symbols
tests/async/test_server.py102 symbols
tests/async/test_client.py99 symbols
tests/common/test_pubsub_manager.py53 symbols
tests/async/test_pubsub_manager.py51 symbols
tests/common/test_packet.py40 symbols
src/socketio/async_server.py36 symbols
tests/common/test_manager.py34 symbols
tests/async/test_manager.py33 symbols
src/socketio/server.py33 symbols
tests/async/test_namespace.py31 symbols

Dependencies from manifests, versioned

@socket.io/admin-ui0.5.1 · 1×
express4.22.2 · 1×
smoothie1.19.0 · 1×
socket.io4.8.0 · 1×
socket.io-client4.8.3 · 1×
Click7.1.2 · 1×
Django4.2.30 · 1×
Flask1.0.2 · 1×
Jinja23.1.6 · 1×
MarkupSafe1.1.0 · 1×
Werkzeug2.2.3 · 1×
aiofiles0.3.0 · 1×

For agents

$ claude mcp add python-socketio \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact