Skip to main content

Easily integrate with your FastAPI app.

Project description


PyPI Changelog License

Easly integrate with your FastAPI app.


Install this plugin using pip:

$ pip install fastapi-socketio


To add SocketIO support to FastAPI all you need to do is import SocketManager and pass it FastAPI object.

from fastapi import FastAPI
from fastapi_socketio import SocketManager

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

Now you can use SocketIO directly from your FastAPI app object.

from .app import app

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

Or you can import SocketManager object that exposes most of the SocketIO functionality.

from .app import socket_manager as sm

async def handle_leave(sid, *args, **kwargs):
    await sm.emit('lobby', 'User left')


To contribute to this library, first checkout the code. Then create a new virtual environment:

cd fastapi-socketio
python -mvenv venv
source venv/bin/activate

Or if you are using pipenv:

pipenv shell

Now install the dependencies and tests:

pip install -e '.[test]'

To run the tests:


Run example

To run the examples simply run:

PYTHONPATH=. python examples/

Before running example make sure you have all dependencies installed.


For list of contributors please reefer to file in this repository.

Project details

Download files

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

Source Distribution

fastapi-socketio-0.0.10.tar.gz (7.2 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page