fastapi-socketio

What it is and what it does

fastapi-socketio is a lightweight wrapper that attaches Socket.IO event handling to a FastAPI application. It exposes Socket.IO functionality through the FastAPI app object or a standalone SocketManager instance, letting you decorate async functions to handle real-time events like client connections, custom messages, and disconnections. The package depends on fastapi and python-socketio to bridge the two frameworks.

The integration is straightforward: instantiate SocketManager with your FastAPI app, then use decorators to define event handlers. You can emit events back to clients and manage bidirectional communication alongside your standard HTTP endpoints. However, the project is archived and has not been updated since early 2023, so it may not reflect recent changes in either FastAPI or Socket.IO.

Use it for:

• Add real-time chat or messaging features to a FastAPI application without managing Socket.IO setup separately
• Build collaborative tools where multiple clients need to receive live updates from the server or other clients
• Create live dashboards or monitoring interfaces that push data to connected clients as events occur
• Implement notification systems that deliver events to specific users or broadcast to all connected sessions

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Integrates Socket.IO real-time bidirectional communication into FastAPI applications, allowing you to add WebSocket-based event handlers alongside HTTP routes.

Yes, if you need Socket.IO integration with FastAPI and can tolerate an unmaintained package. The low install friction and permissive license make it easy to adopt, and it has moderate popularity. However, the abandoned status since 2023 means you should verify compatibility with your target FastAPI and python-socketio versions, and be prepared to fork or patch if issues arise. Not recommended for production systems requiring active upstream support.

Install

fastapi-socketio on PyPI

pip install fastapi-socketio

uv add fastapi-socketio

poetry add fastapi-socketio

Installing fastapi-socketio

Before you install

Low friction to install, but the project is archived and abandoned as of late 2023. The last commit was 2023-11-26 and no updates have been released since 2023-03-03. Consider whether you need active maintenance before adopting.

License in practice

Licensed under Apache License, Version 2.0, a permissive license that allows commercial and private use with minimal restrictions. You may use, modify, and distribute the package freely provided you include the license notice.

Quickstart

pip install fastapi-socketio

from fastapi import FastAPI
from fastapi_socketio import SocketManager

app = FastAPI()
socket_manager = SocketManager(app=app)

@app.sio.on('join')
async def handle_join(sid, *args, **kwargs):
    await app.sio.emit('lobby', 'User joined')

Verify before relying

• Compatibility with recent versions of FastAPI and python-socketio, given the project's abandoned status since 2023
• Whether the package works with modern Python versions and async/await patterns in current FastAPI releases
• Active community forks or maintained alternatives if upstream issues arise

Package facts

Evidence: fastapi_socketio-0.0.10-py3-none-any.whl

Tags

More Application Frameworks packages