Austial is the batteries-included framework that gives FastAPI modules, dependency injection and a real request lifecycle, so your codebase stays easy to change as it grows.
( Built on proven foundations )
( What is Austial )
Built on FastAPI and inspired by NestJS, Austial blends proven architecture with Python's type hints, keeping projects organised and easy to maintain.
Organise apps into self-contained modules that own their controllers and providers.
Constructor injection resolved by type hints. No tokens or glue code.
Declare routes, guards and pipes right where they apply.
Type hints and Pydantic keep inputs and outputs honest end to end.
Guards, pipes, interceptors and filters in a predictable order.
Entities, repositories and migrations built on SQLAlchemy and Alembic.
A testing module with provider overrides and an in-process client.
FastAPI is a fantastic toolkit, but it doesn't prescribe how to organise an application. Austial adds modules, dependency injection and a request lifecycle on top, so large codebases stay readable and testable.
Guards, pipes, interceptors and exception filters wrap every handler in a predictable order.
class ApiKeyGuard(CanActivate):
async def can_activate(self, context: ExecutionContext) -> bool:
request = context.switch_to_http().get_request()
return request.headers.get("x-api-key") == "expected-value"A falsy result short-circuits the pipeline with a 403 Forbidden.
Scaffold a project and generate modules, controllers and services without leaving the terminal.
Every project ships rules for AI coding tools, so assistants follow your architecture instead of guessing.
AGENTS.md
# AGENTS.md
This is an **Austial** application: a NestJS-style,
batteries-included web framework for Python, built on FastAPI.
## Commands
uv run austial serve # dev server on :8000 with reload
uv run austial g resource <name> # scaffold a full CRUD feature module( Production ready )
14 documented techniques across 17 packages. Pick what you need, ignore the rest.
Guards, strategies and policy checks for who can do what.
Entities, repositories and versioned schema changes.
Queue work out of the request path and retry it safely.
Terminus-style indicators for readiness and liveness.
Isolate tenants per request without rewriting your services.
A trail of who did what, plus hardened defaults.
from austial import AustialFactory
from .app_module import AppModule
app = AustialFactory.create(AppModule, title="my-app")
async def bootstrap() -> None:
await app.listen(8000)( Learn )
Follow the guides in order, or jump straight to the part of the framework you need.
17
Packages in the box
( Click. Copy. Build. )