autumn-framework 0.1.1

Modern web-framework

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