Packages
Internal utilities — not part of the public API.
Thin LLM streaming for chirp. Provider string in, typed async iterables out.
Chirp CLI — project scaffolding, dev server, and contract validation.
Typed async database access for chirp. SQL in, frozen dataclasses out.
HTTP abstractions — Request, Response, Headers, QueryParams, FormData. This subpackage has zero internal dependencies.
Middleware — Protocol-based, no inheritance required.
Filesystem-based routing with automatic layout nesting. Combines co-located routes and templates, automatic layout...
Real-time — Server-Sent Events and EventStream.
Routing — compiled route table with O(path-depth) matching.
Security utilities — route protection and password hashing.
Server — ASGI handler and development server.
Kida template integration — not a dependency, a feature.
Test utilities for chirp applications. Provides a test client, fragment assertions, htmx header assertions, and SSE...
MCP tool support for chirp. Register functions as MCP tools alongside HTTP routes.
Form validation — composable rules, clean results.
Modules
Chirp application class.
Chirp — A Python web framework for the modern web platform.
Application configuration.
Request-scoped context via ContextVar. Provides: - ``request_var``: The current ``Request`` for this task/thread. -...
Typed hypermedia contracts — compile-time validation of the server-client surface.
Chirp exception hierarchy.
Typed extraction of query parameters and form/JSON body data. Automatically populates frozen dataclass instances...
Shared source protocols and types. A *source* is anything that produces typed data — a database, an LLM, a...