rcsalles / awesome-asgi

A curated list of awesome ASGI servers, frameworks, apps, libraries, and other resources

awesome-asgi

A curated list of awesome ASGI servers, frameworks, apps, libraries, and other resources.

This list should help you keep yourself up to date with the most awesome ASGI projects and resources. You can watch releases on this repo to be notified about new entries. If you find anything missing, please contribute. ❣️

ASGI is a standard interface positioned as a spiritual successor to WSGI. It enables communication and interoperability across the whole Python async web stack: servers, applications, middleware, and individual components.

Born in 2016 to power the Django Channels project, ASGI and its ecosystem have been expanding ever since, boosted by the arrival of projects such as Starlette and Uvicorn in 2018.

Contents

• Application frameworks
• Authentication
• End-user applications
• GraphQL
• Monitoring
• Proxies
• Real-time web
• Resources
  • Reference
  • Talks
  • Tutorials
• Security
• Serialization
• Serverless
• Servers
• Testing

Application frameworks

Frameworks for building ASGI web applications.

• Channels - Asynchronous support for Django, and the original driving force behind the ASGI project. Supports HTTP and WebSockets with Django integration, and any protocol with ASGI-native code.
• Django - The web framework for perfectionists with deadlines. Has native ASGI support since version 3.0.
• FastAPI - A modern, high-performance web framework for building APIs with Python 3.6+ based on standard Python type hints. Powered by Starlette and Pydantic. Supports HTTP and WebSockets.
• Quart - A Python ASGI web microframework whose API is a superset of the Flask API. Supports HTTP (incl. SSE and HTTP/2 server push) and WebSockets.
• Responder - A familiar HTTP Service Framework for Python, powered by Starlette.
• Sanic - Sanic is a Python 3.6+ web server and web framework that's written to go fast. It allows the usage of the async/await syntax added in Python 3.5, which makes your code non-blocking and speedy. Supports HTTP and WebSockets.
• Starlette - Starlette is a lightweight ASGI framework/toolkit, which is ideal for building high performance asyncio services. Supports HTTP and WebSockets.
• Tonberry - Tonberry is an ASGI framework that takes a class based approach to routing. Influenced by CherryPy but made compatible with asyncio and WebSockets.

Authentication

Packages for adding authentication and managing users in ASGI web applications.

• asgi-auth-github - GitHub OAuth authentication for ASGI apps. Supports restricting to specific users or member of specific teams or organizations.
• SessionAuth - Authenticate using sessions and cookies. (Shipped with Piccolo API, and requires Piccolo ORM.)
• TokenAuth - Authenticate using tokens in request headers. (Shipped with Piccolo API, and requires Piccolo ORM.)

End-user applications

Real-world applications that run on ASGI.

• Datasette - A tool for exploring and publishing data, including ASGI-compatible components and plugins.

GraphQL

Packages for building GraphQL APIs via ASGI.

• Ariadne - A Python library for implementing GraphQL servers.
• tartiflette-asgi - ASGI support for the Tartiflette GraphQL engine.

Monitoring

Packages for monitoring ASGI web applications.

• Scout APM Starlette - Scout APM integration with Starlette and Starlette-based frameworks. (Shipped with scout-apm.)
• Sentry ASGI - Sentry integration for ASGI frameworks. (Shipped with sentry-sdk.)
• timing-asgi - ASGI middleware to record and emit timing metrics.

Proxies

Packages for use when running ASGI web applications behind proxies.

• ProxyHeadersMiddleware - Use X-Forwarded-Proto and X-Forwarded-For headers set by a known and trusted proxy to make client and scheme reference the connecting client (shipped with Uvicorn).

Real-time web

Packages for use when building real-time-capable ASGI web applications.

• python-socketio - WebSocket clients and servers using Socket.IO. Includes an ASGI application wrapper.

Resources

Content about ASGI itself: concepts, history, usage, etc.

Publications

Articles, blog posts and other publications about ASGI.

• 2019-08-11 - Introduction to ASGI: Emergence of an Async Python Web Ecosystem - Florimond Manca.
• 2019-03-20 - ASGI 3.0, Andrew Godwin.
• 2018-06-17 - Embracing ASGI with Quart; Introducing Hypercorn, Philip Jones.
• Undated - Hello ASGI, Tom Christie.

Reference

Reference documentation and implementation for ASGI.

• ASGI Documentation - Documentation site for the ASGI specification.
• asgiref - ASGI reference implementation, including function wrappers, server base classes and a WSGI-to-ASGI adapter.

Talks

Talks about ASGI.

• 2019-06-15 - An introduction to ASGI, Asynchronous Server Gateway Interface, P G Jones, PyLondinium 2019.
• 2019-04-12 - Sketching out A Django redesign, Tom Christie, DjangoCon Europe.
• 2018-07-27 - Quart; an ASGI alternative to Flask, P G Jones, EuroPython 2018.
• 2018-05 - Taking Django Async, Andrew Godwin, PyCon.
• 2017-11 - Future Pythonic Web: ASGI & Daphne, Dmitry Nazarov, PiterPy.

Tutorials

Tutorials about working with ASGI applications and components.

• 2019-08-26 - Quick and dirty mock service with Starlette, Matt Layman.
• 2018-06-22 - Writing an ASGI web framework, Yoong Kang Lim.
• Undated - Working with ASGI and HTTP, Tom Christie.

Security

Packages and components for managing the security of ASGI web applications.

• CORSMiddleware - Allow cross-origin requests from browsers. (Shipped with Starlette.)
• CSPMiddleware - Tell browsers to only run Javascript from the same origin. (Shipped with Piccolo API.)
• CSRFMiddleware - Protect against CSRF attacks when using cookies for authentication. (Shipped with Piccolo API.)
• HTTPSRedirectMiddleware - Redirect HTTP/WS traffic to HTTPS/WSS. (Shipped with Starlette.)
• RateLimitingMiddleware - Protect sensitive endpoints from brute force attacks. (Shipped with Piccolo API.)
• TrustedHostMiddleware - Guard against host header attacks by validating the Host header of requests. (Shipped with Starlette.)

Serialization

Packages and components for converting the format of data in and out of ASGI web applications.

• brotli-asgi - Response content compression using Brotli.
• GZipMiddleware - Response content compression using GZip. (Shipped with Starlette.)
• msgpack-asgi - Drop-in MessagePack support for ASGI apps and frameworks.

Serverless

Packages for building serverless web applications with ASGI.

• Mangum - AWS Lambda & API Gateway support for ASGI.

Servers

Web servers for ASGI applications.

• Daphne - An HTTP, HTTP2 and WebSocket protocol server for ASGI, developed to power Django Channels.
• Hypercorn - An ASGI server based on the sans-io hyper, h11, h2, and wsproto libraries. Supports HTTP/1, HTTP/2, WebSockets, ASGI 2.0 and ASGI 3.0. Compatible with asyncio, uvloop and trio worker types.
• Uvicorn - A fast ASGI server based on uvloop and httptools. Supports HTTP/1 and WebSockets.

Testing

Packages for testing ASGI applications.

• asgi-lifespan - Programmatic startup/shutdown of ASGI apps. Allows testing an ASGI app without having to spin up a server.
• async-asgi-testclient - A framework-agnostic library for testing ASGI web applications.
• HTTPX - Next generation HTTP client, including async support and ability to call ASGI apps directly.