# QuadKit

> Oridecon Labs builds an open-source Python foundation for AI backends. Protocols, a typed DI container, an application lifecycle, the Result error model, an ASGI web layer, a CLI, and a testing harness — 13 packages, Apache 2.0, Python 3.11+.

QuadKit is alpha (0.0.x), public release 0.0.42, Apache 2.0 licensed, Python 3.11+. Prefer protocols over concrete classes. Pin `>=0.0.42,<0.1`. Extensions depend only on `quadkit` and `quadkit-contracts`, never on each other.

# Per-package LLM indexes

One file per package so a SQL or RAG task does not load the whole catalog. Rules: https://oridecon.dev/agents.md · Full index: https://oridecon.dev/llms.txt

## Foundation

- [quadkit](https://oridecon.dev/llms/quadkit.txt) — Async-first core: the DI container, application lifecycle, providers, modules, typed config, and the Result model.
- [quadkit-contracts](https://oridecon.dev/llms/quadkit-contracts.txt) — Protocols, shared types, and the exception hierarchy — zero runtime dependencies beyond typing-extensions.

## Web & HTTP

- [quadkit-web](https://oridecon.dev/llms/quadkit-web.txt) — The async web layer: controllers with signature-based binding, middleware pipelines, a Result-to-HTTP bridge, and OpenAPI.
- [quadkit-http](https://oridecon.dev/llms/quadkit-http.txt) — HTTP client with typed Result errors, retries, timeouts, and a pluggable transport for calling other services.

## Data

- [quadkit-sql](https://oridecon.dev/llms/quadkit-sql.txt) — Async SQL repositories: typed rows, migrations, connection pooling, and a repository base over SQLAlchemy and asyncpg.
- [quadkit-cache](https://oridecon.dev/llms/quadkit-cache.txt) — Cache primitives: a Cache protocol, in-memory and Redis backends, stampede-safe single-flight helpers, and TTL invalidation.
- [quadkit-storage](https://oridecon.dev/llms/quadkit-storage.txt) — Artifact storage: a BlobStore protocol, local and S3 backends, content-addressed keys, and signed URL helpers.

## Events

- [quadkit-events](https://oridecon.dev/llms/quadkit-events.txt) — Event bus, outbox publishing, durable subscriptions, and a timeline/replay API for auditing what happened.

## Infra

- [quadkit-tasks](https://oridecon.dev/llms/quadkit-tasks.txt) — Background tasks: a queue, worker pools, retries with backoff, schedules, and an HTTP console for observing runs.
- [quadkit-monitor](https://oridecon.dev/llms/quadkit-monitor.txt) — Observability: counters, histograms, structured logs, health/readiness probes, and a metrics endpoint.

## Security

- [quadkit-auth](https://oridecon.dev/llms/quadkit-auth.txt) — Authentication and authorization: API keys, MFA, RBAC, session stores, and login flows wired through the DI container.

## Tooling

- [quadkit-cli](https://oridecon.dev/llms/quadkit-cli.txt) — The quadkit command line: project scaffolding, generators, a smart runner, and admin commands.
- [quadkit-testing](https://oridecon.dev/llms/quadkit-testing.txt) — Test harnesses, fakes, and fixtures that boot the real application in-process.