ASGI server

WSRPC provides two-way remote procedure calls over one WebSocket connection. Both peers can expose methods, make concurrent calls and receive results or remote exceptions. This project is an ASGI fork of wsrpc-aiohttp, preserving its RPC protocol and bundled JavaScript clients.

The server uses the standard ASGI interface and has no runtime dependencies. The optional Python client uses websockets. Python 3.10+ and asyncio are supported, including free-threaded CPython. Trio event loops are not supported.

pip install 'wsrpc-asgi[fastapi,client]' uvicorn

Start with the shared quick start and choose your framework tab. The pages below cover transport-specific behavior and complete browser demos.

• FastAPI browser demo
  • FastAPI and a browser
  • Python client
• ASGI integration details
  • FastAPI
  • Starlette
  • Django
  • Django Channels
  • Quart
  • Litestar
  • Falcon
  • Sanic
  • BlackSheep
  • Bare ASGI and other frameworks
  • Lifecycle and servers
• Routes and connections
  • Function routes
  • Connection-scoped routes
  • Reverse calls and events
  • Python and JavaScript clients
  • Configuration and limits
  • JSON and custom serialization
  • Authorization, state and broadcast
• Signals
• Migrating from wsrpc-aiohttp
  • Server changes
  • Python client changes
• Developing the ASGI library
  • Verification
  • Documentation
  • Packaging and release
• API reference
  • wsrpc-asgi API

For aiohttp applications, see the aiohttp guide.

Created by Dmitry Orlov. The Python library is licensed under Apache-2.0; the bundled JavaScript client is licensed under MIT.