Packages
Internal utilities — not part of the public API.
Thin LLM streaming for chirp. Provider string in, typed async iterables out.
Chirp application facade.
Chirp caching framework. Three levels of caching: 1.
Chirp CLI — project scaffolding, dev server, and contract validation.
Typed hypermedia contracts package.
Typed async database access for chirp. SQL in, frozen dataclasses out.
Chirp extensions — optional integrations (chirp-ui, etc.).
HTTP abstractions — Request, Response, Headers, QueryParams, FormData. This subpackage has zero internal dependencies.
Chirp internationalization (i18n).
Markdown rendering for chirp via patitas.
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 — 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. -...
Domain protocol for pluggable feature modules.
Chirp exception hierarchy.
Typed extraction of query parameters and form/JSON body data. Automatically populates frozen dataclass instances...
Health probes for Kubernetes and load balancers.
Structured logging with request correlation.
Plugin protocol — structural typing for reusable Chirp plugins.
Resilience patterns for external dependencies. Documents recommended patterns for timeouts, retries, and circuit...
Shell action constants — shared by pages and templating without circular deps.
Stable DOM ids for Chirp + ChirpUI *shell regions* (HTMX OOB targets). Shell regions live **outside**...
Shared source protocols and types. A *source* is anything that produces typed data — a database, an LLM, a...