github.com/litestar-org/litestar @v2.24.0

Project		Status
CI/CD
Quality
Package
Community
Meta

Litestar is a powerful, flexible yet opinionated ASGI framework, focused on building APIs. It offers high-performance data validation, dependency injection, first-class ORM integration, authorization primitives, a rich plugin API, middleware, and much more that's needed to get applications up and running.

Check out the documentation 📚 for a detailed overview of its features!

Additionally, the Litestar fullstack repository can give you a good impression how a fully fledged Litestar application may look.

Table of Contents

• Installation
• Quick Start
• Core Features
• Example Applications
• Features
• Class-based Controllers
• Data Parsing, Type Hints, and Msgspec
• Plugin System, ORM support, and DTOs
• OpenAPI
• Dependency Injection
• Middleware
• Route Guards
• Request Life Cycle Hooks
• Performance
• Contributing

Installation

pip install litestar

or to include the CLI and a server (uvicorn) for running your application:

pip install 'litestar[standard]'

Quick Start

```python title="app.py" from litestar import Litestar, get

@get("/") async def hello_world() -> dict[str, str]: """Keeping the tradition alive with hello world.""" return {"hello": "world"}

app = Litestar(route_handlers=[hello_world])

And run it with

```bash
litestar run

Core Features

• Class based controllers
• Dependency Injection
• Layered Middleware
• Plugin System
• OpenAPI 3.1 schema generation
• Life Cycle Hooks
• Route Guards based Authorization
• Support for dataclasses, TypedDict, msgspec, pydantic version 1 and version 2 (even within the same application) and (c)attrs
• Layered parameter declaration
• Support for RFC 9457 standardized "Problem Detail" error responses
• Automatic API documentation with:
• Scalar
• RapiDoc
• Redoc
• Stoplight Elements
• Swagger-UI
• Trio support (built-in, via AnyIO)
• Ultra-fast validation, serialization and deserialization using msgspec
• SQLAlchemy integration

Example Applications

Pre-built Example Apps

• litestar-hello-world: A bare-minimum application setup. Great for testing and POC work.
• litestar-fullstack: A reference application that contains most of the boilerplate required for a web application. It features a Litestar app configured with best practices, SQLAlchemy 2.0 and SAQ, a frontend integrated with Vitejs and Jinja2 templates, Docker, and more. Like all Litestar projects, this application is open to contributions, big and small.

Sponsors

Litestar is an open-source project, and we enjoy the support of our sponsors to help fund the exciting work we do.

A huge thanks to our sponsors:

<a href="https://telemetrysports.com/" title="Telemetry Sports - Changing the way data