# Korvex

> A fast Python web framework, with a router and an HTTP server written in Rust.

Korvex is a fast Python web framework (ASGI), with a router and an HTTP server written in Rust. Handlers are plain functions whose parameters say what they read; validation uses msgspec or pydantic. Python 3.9 to 3.14, free-threaded 3.14t included. Korvex 1.0 is in release candidates: install with `pip install --pre korvex` (plain `pip install korvex` gives 0.17, an older API); the API rc1 froze won't break.


## Start

- [Home](https://3d3n-pyc.github.io/korvex/index.md): What Korvex is, and a first app
- [Tutorial](https://3d3n-pyc.github.io/korvex/tutorial/index.md): Your first API, step by step, for beginners
- [Glossary](https://3d3n-pyc.github.io/korvex/glossary/index.md): Plain-words definitions of the terms used in the guide

## Guide

- [Routes](https://3d3n-pyc.github.io/korvex/routes/index.md): Paths, parameters, groups, hosts, url_for, static files with conditional and range requests, mounting another ASGI app
- [Validation](https://3d3n-pyc.github.io/korvex/validation/index.md): Typed parameters, models (msgspec, pydantic, dataclasses, TypedDict), headers, cookies, forms, 422 errors
- [Requests and responses](https://3d3n-pyc.github.io/korvex/requests-and-responses/index.md): What a handler gets and returns, streams, Server-Sent Events, background tasks, Response.file with range and 304
- [Templates](https://3d3n-pyc.github.io/korvex/templates/index.md): HTML templates, filters, escaping, hashed static URLs
- [Sessions and CSRF](https://3d3n-pyc.github.io/korvex/sessions/index.md): Signed-cookie sessions, flash messages, CSRF protection
- [Dependencies](https://3d3n-pyc.github.io/korvex/dependencies/index.md): Depends, yield dependencies, overrides
- [Errors and hooks](https://3d3n-pyc.github.io/korvex/errors-and-hooks/index.md): HTTPException, Abort, exception handlers, before/after hooks, startup/shutdown, app.local
- [WebSockets](https://3d3n-pyc.github.io/korvex/websockets/index.md): WebSocket routes
- [OpenAPI and security](https://3d3n-pyc.github.io/korvex/openapi/index.md): OpenAPI, Swagger UI, Bearer, API keys, OAuth2, custom schemes
- [Ready-made middleware](https://3d3n-pyc.github.io/korvex/middleware/index.md): CORS, request IDs, rate limiting, compression, security headers
- [Testing](https://3d3n-pyc.github.io/korvex/testing/index.md): TestClient and AsyncTestClient, pytest fixtures, streams, iter_events for Server-Sent Events
- [The built-in server](https://3d3n-pyc.github.io/korvex/server/index.md): The built-in server, workers and threads, root_path, connection and body limits
- [Deployment](https://3d3n-pyc.github.io/korvex/deployment/index.md): Production checklist, default limits, nginx, Caddy, Docker, AWS Lambda, Vercel

## Reference

- [The App](https://3d3n-pyc.github.io/korvex/reference/app/index.md)
- [Errors](https://3d3n-pyc.github.io/korvex/reference/errors/index.md)
- [korvex.middleware](https://3d3n-pyc.github.io/korvex/reference/middleware/index.md)
- [Parameters](https://3d3n-pyc.github.io/korvex/reference/parameters/index.md)
- [Requests](https://3d3n-pyc.github.io/korvex/reference/requests/index.md)
- [Responses](https://3d3n-pyc.github.io/korvex/reference/responses/index.md)
- [korvex.router](https://3d3n-pyc.github.io/korvex/reference/router/index.md)
- [korvex.security](https://3d3n-pyc.github.io/korvex/reference/security/index.md)
- [Templates](https://3d3n-pyc.github.io/korvex/reference/templates/index.md)
- [korvex.testing](https://3d3n-pyc.github.io/korvex/reference/testing/index.md)

## Optional

- [Performance](https://3d3n-pyc.github.io/korvex/performance/index.md): Benchmarks
- [The standalone router](https://3d3n-pyc.github.io/korvex/router/index.md): The standalone Rust router
- [AI](https://3d3n-pyc.github.io/korvex/ai/index.md): llms.txt, the agent skill, AGENTS.md