ASGI-Tools Documentation#

Lightweight, high-performance ASGI toolkit for modern Python async apps.

Overview#

ASGI-Tools is a minimal, extensible ASGI toolkit designed to help you build async Python applications faster and more efficiently.

Async Support – Seamless integration with Asyncio, Trio, and Curio
High Performance – Optimized for speed and minimal resource usage
Rich Request Handling – Powerful Request supporting headers, cookies, forms, and file uploads
Flexible Responses – Multiple response types: HTTP, static files, streaming, SSE, WebSocket via Response
Built-in Middleware – Essential middleware for common patterns:
- RequestMiddleware – Request parsing
- ResponseMiddleware – Response handling
- RouterMiddleware – URL routing
- LifespanMiddleware – Application lifecycle
- StaticFilesMiddleware – Static file serving
Testing Support – Built-in test client with WebSocket support via ASGITestClient
Simple Application Builder – Quick-start with App

Install ASGI-Tools with pip:

pip install asgi-tools

Here’s a minimal example to get you started:

from asgi_tools import App

app = App()

@app.route("/")
async def hello(request):
    return "Hello, World!"

Run it with an ASGI server like uvicorn:

uvicorn app:app

Visit http://127.0.0.1:8000/ to see your application running!

For detailed information on functions, classes, and methods:

ASGI-Tools is an open source project. Contributions, issues, and feature requests are welcome!