Fast, lightweight, asynchronous ASGI web framework for Python 3.11+. Documentation: https://klen.github.io/muffin
Muffin combines the simplicity of microframeworks with native ASGI performance, supporting multiple async libraries (Asyncio, Trio, Curio) out of the box. Its plugin ecosystem covers templating, databases, auth and more.
Key features:
- ASGI compatible
- Competitive performance
- Supports Asyncio, Trio and Curio
- Multiple response types: text, HTML, JSON, streams, files, SSE, WebSockets
- First-class plugin system
Muffin requires Python 3.11 or newer. We recommend using the latest stable Python.
$ pip install muffinFor the standard installation with gunicorn, uvicorn, uvloop and httptools:
$ pip install muffin[standard]Dependencies installed automatically:
- ASGI-Tools: ASGI toolkit
- Modconfig: hierarchical configuration manager
Create a simple "Hello User" app:
import muffin
app = muffin.Application()
@app.route("/", "/hello/{name}")
async def hello(request):
name = request.path_params.get("name", "world")
return f"Hello, {name.title()}!"Save this as example.py and run:
$ uvicorn example:appVisit http://localhost:8000 or http://localhost:8000/hello/username in your browser.
- muffin-jinja2: Jinja2 templates (asyncio/trio/curio)
- muffin-session: signed cookie-based HTTP sessions
- muffin-oauth: OAuth1/OAuth2 integration
- muffin-sentry: Sentry error tracking
- muffin-peewee-aio: Peewee ORM integration with async support
- muffin-babel: localization with Babel
- muffin-databases: async support for a range of databases
- muffin-mongo: MongoDB integration
- muffin-redis: Redis integration
- muffin-rest: REST helpers
- muffin-apiclient: support for external APIs
- muffin-grpc: gRPC support
- muffin-kafka: Kafka integration
- muffin-admin: admin interface
- muffin-prometheus: Prometheus metrics exporter
See each repo for usage and installation instructions.
Performance comparisons are available at http://klen.github.io/py-frameworks-bench/.
Found a bug or have a feature request? Please open an issue at https://github.com/klen/muffin/issues.
Muffin is licensed under the MIT license.
Muffin > 0.40 (completely rewritten on ASGI)
Muffin < 0.40 (based on AIOHTTP)
