Thirteen packages, all Apache 2.0, all alpha (0.0.x) — current release 0.0.42. The two foundation packages — quadkit and quadkit-contracts — are all you need to start. Everything else is optional: install only what the app uses.
Every extension depends only on quadkit and quadkit-contracts, never on another extension.
Foundation quadkit → Application, container, providers, modules, Result, YAML config quadkit-contracts → Zero dependencies (protocols, types, exceptions)Web quadkit-web → ASGI, controllers, routing, middleware, OpenAPI quadkit-http → Outbound HTTP client: typed Result errors, retries, timeoutsData quadkit-sql → Async SQL: repositories, migrations, pooling quadkit-cache → Cache protocol, in-memory and Redis, single-flight helpers quadkit-storage → BlobStore protocol, local and S3, content-addressed keysEvents quadkit-events → Event bus, outbox, durable subscriptions, replayInfra quadkit-tasks → Queues, worker pools, schedules, task console quadkit-monitor → Counters, histograms, health probes, metrics endpointSecurity quadkit-auth → API keys, MFA, RBAC, sessions, login flowsTooling quadkit-cli → Scaffolding, generators, dev server quadkit-testing → Test harnesses, fakes, fixturesStart from the CLI. Templates pick the packages; you add the rest later.
uv add "quadkit-cli>=0.0.42,<0.1"quadkit new project my-app --template web-apiquadkit runThis catalog is the same list as The Ecosystem and the sidebar. Canonical URLs live under /packages/{group}/…. Ungrouped /packages/quadkit-* paths redirect here.
Foundation
The container, the lifecycle, and the contracts everything else builds on.
| Package | What it does |
|---|---|
quadkit | Async-first core: the DI container, application lifecycle, providers, modules, typed config, and the Result model. |
quadkit-contracts | Protocols, shared types, and the exception hierarchy — zero runtime dependencies beyond typing-extensions. |
Web & HTTP
ASGI, routing, middleware, and the Result-to-HTTP bridge.
| Package | What it does |
|---|---|
quadkit-web | The async web layer: controllers with signature-based binding, middleware pipelines, a Result-to-HTTP bridge, and OpenAPI. |
quadkit-http | HTTP client with typed Result errors, retries, timeouts, and a pluggable transport for calling other services. |
Data
Relational and document storage behind repositories.
| Package | What it does |
|---|---|
quadkit-sql | Async SQL repositories: typed rows, migrations, connection pooling, and a repository base over SQLAlchemy and asyncpg. |
quadkit-cache | Cache primitives: a Cache protocol, in-memory and Redis backends, stampede-safe single-flight helpers, and TTL invalidation. |
quadkit-storage | Artifact storage: a BlobStore protocol, local and S3 backends, content-addressed keys, and signed URL helpers. |
Events
Publish, subscribe, replay.
| Package | What it does |
|---|---|
quadkit-events | Event bus, outbox publishing, durable subscriptions, and a timeline/replay API for auditing what happened. |
Infra
Background work and operational visibility.
| Package | What it does |
|---|---|
quadkit-tasks | Background tasks: a queue, worker pools, retries with backoff, schedules, and an HTTP console for observing runs. |
quadkit-monitor | Observability: counters, histograms, structured logs, health/readiness probes, and a metrics endpoint. |
Security
Identity, sessions, and access control.
| Package | What it does |
|---|---|
quadkit-auth | Authentication and authorization: API keys, MFA, RBAC, session stores, and login flows wired through the DI container. |
Tooling
Scaffold, run, and test a project: the CLI and the testing harness.
| Package | What it does |
|---|---|
quadkit-cli | The quadkit command line: project scaffolding, generators, a smart runner, and admin commands. |
quadkit-testing | Test harnesses, fakes, and fixtures that boot the real application in-process. |
Next Steps
Section titled “Next Steps”- The Ecosystem — grouped by purpose, with install examples
- Adoption Paths — scaffold → test → ship
- Architecture — why extensions never import each other
- Installation — pin
0.0.xand scaffold