https://github.com/de4oult/autumn
Modern Python ASGI web framework
https://github.com/de4oult/autumn
asgi async autumn dependency-injection framework openapi package pip pip3 pypi python rest restful web websocket
Last synced: 2 months ago
JSON representation
Modern Python ASGI web framework
- Host: GitHub
- URL: https://github.com/de4oult/autumn
- Owner: De4oult
- License: mit
- Created: 2026-01-24T11:06:32.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-04-14T09:05:09.000Z (2 months ago)
- Last Synced: 2026-04-14T16:32:17.304Z (2 months ago)
- Topics: asgi, async, autumn, dependency-injection, framework, openapi, package, pip, pip3, pypi, python, rest, restful, web, websocket
- Language: HTML
- Homepage: https://autumnframework.web.app
- Size: 472 KB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Autumn
A modern ASGI web framework focused on typed controllers, dependency injection, and clean configuration.
__Autumn__ is a Python web framework for building HTTP APIs and WebSocket applications with a small, explicit core. It leans on Python's type system instead of large decorator stacks: route parameters are typed, request bodies are inferred from Pydantic models, dependencies are injected from signatures, and responses can be serialized automatically.
If you want class-based controllers, typed configuration, built-in dependency injection, OpenAPI/Dependencies docs generation, and CORS support, Autumn is built for that style.
## Highlights
- ASGI-first application object that works with standard ASGI servers such as `uvicorn`
- Class-based REST controllers with typed path parameters like `{id:int}` and `{file:path}`
- Signature-driven dependency injection with `@service` and `@leaf`
- Automatic request body validation from Pydantic annotations
- Automatic JSON serialization for Pydantic return values
- Built-in configuration system with environment, JSON, and YAML sources
- Built-in configs for application settings, CORS, and WebSocket tuning
- OpenAPI and dependencies documentation generation with built-in viewer
- Middleware hooks, lifespan hooks, file responses, redirects, and streaming
- WebSocket routes with dependency injection support
## Why Autumn
__Autumn__ tries to keep the ergonomic parts of modern Python frameworks while staying direct:
- Controllers are just Python classes.
- Dependencies come from constructor or method signatures.
- Request bodies are inferred from type annotations instead of extra decorators.
- Configs are plain Python classes with typed fields.
- The framework stays close to raw ASGI concepts when you need to drop lower.
That makes the happy path concise, while still keeping the codebase readable when the application grows.
## Benchmarks
Latest local benchmark run: `2026-04-17`
Environment:
- Windows
- Python `3.12`
- `uvicorn --workers 1 --loop asyncio --http h11 --lifespan off`
- Concurrency: `64`
- Warmup: `2s`
- Measurement duration: `5s`
Average across `plaintext`, `json`, `path_parameter`, and `body` scenarios:
| Framework | Avg RPS | Avg P95 (ms) |
| ----------- | ------: | -----------: |
| Falcon | 4471.53 | 16.66 |
| __Autumn__ | 4006.67 | 17.38 |
| FastAPI | 3644.17 | 19.49 |
| Flask | 2149.76 | 33.06 |
In this run, Autumn is:
- `86.37%` faster than Flask on average
- `9.95%` faster than FastAPI on average
- `10.39%` slower than Falcon on average
## Philosophy
__Autumn__ favors:
- strong typing over implicit magic
- signatures over decorator-heavy ceremony
- built-in primitives over mandatory third-party integration
- readable application structure over framework cleverness
The goal is to make small apps pleasant and larger apps maintainable.
## Author
```
_ _ _ _ _
__| | ___| || | ___ _ _| | |_
/ _` |/ _ \ || |_ / _ \| | | | | __|
| (_| | __/__ _| (_) | |_| | | |_
\__,_|\___| |_| \___/ \__,_|_|\__|
```
## __Thank you a lot!__
## How to reach me
