# QuadKit > Oridecon Labs is an AI product engineering studio designing and building software products, and the team behind QuadKit — an async-first, contract-driven Python framework for coding agents. Its open-source catalog of 18 packages is published at 0.0.50 (Apache 2.0, Python 3.11+). QuadKit is alpha (0.0.x), public release 0.0.50, Apache 2.0 licensed, Python 3.11+. Prefer protocols over concrete classes. Pin `>=0.0.50,<0.1`. Package-boundary rules vary by family; regular extension independence has tracked exceptions and composite packages have separate contracts. ## How to learn this codebase Read in this order. Do not scrape the splash page for rules. 1. https://oridecon.dev/llms.txt — this file (identity, install, rules, catalog) 2. https://oridecon.dev/agents.md — hierarchy, Result vs exceptions, provider lifecycle, never-list 3. https://oridecon.dev/quadkit/getting-started/for-coding-agents/ — repo map, one project tree, recipes 4. https://oridecon.dev/quadkit/getting-started/common-mistakes/ — fail vs fix 5. https://oridecon.dev/SKILL.md — umbrella skill; pack: https://github.com/dbtinoy-/quadkit-skills; install: https://oridecon.dev/quadkit/getting-started/agent-skills/ 6. https://oridecon.dev/quadkit/packages/ — the published packages, one page per GUIDE/QUICKSTART/CONFIGURATION 7. Prefer protocols in `quadkit-contracts` over concrete classes in extensions Published packages (18): `quadkit`, `quadkit-contracts`, `quadkit-web`, `quadkit-http`, `quadkit-ai-llm`, `quadkit-ai-agents`, `quadkit-ai-mcp`, `quadkit-sql`, `quadkit-cache`, `quadkit-storage`, `quadkit-events`, `quadkit-notification`, `quadkit-tasks`, `quadkit-workflow`, `quadkit-monitor`, `quadkit-auth`, `quadkit-cli`, `quadkit-testing`. ## Install - `uv add "quadkit-cli>=0.0.50,<0.1"` then `quadkit new project my-app --template api` - or `uv add quadkit` / `pip install quadkit` - Web & HTTP: the `api` starter includes `quadkit-web`; add `quadkit-http` for outbound requests - Data & Storage: `uv add quadkit-sql quadkit-cache quadkit-storage` - Events & Tasks: `uv add quadkit-events quadkit-tasks` - Auth & Monitoring: `uv add quadkit-auth quadkit-monitor` - AI, MCP, workflows & notifications: `uv add quadkit-ai-llm quadkit-ai-agents quadkit-ai-mcp quadkit-workflow quadkit-notification` - Testing: `uv add --dev quadkit-testing` - Agent skills pack (markdown, not PyPI): `npx skills add dbtinoy-/quadkit-skills` ## Useful Links - [Documentation](https://oridecon.dev/): human docs, this site - [Full LLM index](https://oridecon.dev/llms-full.txt): expanded catalog plus architecture notes - [Agent rules](https://oridecon.dev/agents.md): distilled AGENTS.md for coding agents - [Skill](https://oridecon.dev/SKILL.md): drop-in SKILL.md for Claude Code, Cursor, OpenCode - [For coding agents](https://oridecon.dev/quadkit/getting-started/for-coding-agents/): read order, repo map, one project tree, recipes - [Common mistakes](https://oridecon.dev/quadkit/getting-started/common-mistakes/): fail vs fix (imports, Result, domains/, register) - [Per-package LLM indexes](https://oridecon.dev/llms/index.txt): one file per package (e.g. https://oridecon.dev/llms/quadkit-web.txt) - [Package overview](https://oridecon.dev/quadkit/ecosystem/): every published package, grouped - [Notes](https://oridecon.dev/blog/): notes on building the framework - [Framework repository](https://github.com/dbtinoy-/quadkit): source code, issues, and releases - [Agent skills](https://github.com/dbtinoy-/quadkit-skills): installable SKILL.md pack for Claude Code, Cursor, OpenCode - [Agent skills (this site)](https://oridecon.dev/quadkit/getting-started/agent-skills/): install commands + catalog - [Changelog](https://oridecon.dev/quadkit/changelog/): 0.0.x product digest - [PyPI](https://pypi.org/project/quadkit/): installable packages - [Installation](https://oridecon.dev/quadkit/getting-started/installation/): install and verify - [Your first app](https://oridecon.dev/quadkit/getting-started/first-app/): CLI scaffold, quadkit run, add a route ## Project layout (one tree) The CLI currently ships one `api` starter. Add installed packages with `quadkit add`; the canonical project tree stays the same. No `--structure` flag. No `models/` directory. Feature code uses `domains/`. App providers live in app-root `di/` (`*_provider.py`). Modules have `provider.py`. Cross-cutting code stays in `shared/`. ``` src// app.py # create_app() — composition root; WebModule.configure(discover=[...]) controllers/ # unscoped HTTP, auto-discovered domains/ # unscoped domain types di/ # app providers (*_provider.py) services/ infrastructure/ # db, cache, events shared/ # errors, middleware, health modules// # quadkit new module protocols.py provider.py domains/ controllers/ ``` - Human docs: https://oridecon.dev/quadkit/getting-started/project-structure/ - CLI map: https://oridecon.dev/quadkit/packages/utilities/quadkit-cli/docs/project_layout/ ## Rules for coding agents These are the non-negotiable rules from the framework AGENTS.md. Violating any of them is a blocking issue. ### Package hierarchy - `quadkit-contracts` imports nothing from the ecosystem. Protocols, types, exceptions only. - `quadkit` imports only from `quadkit-contracts`. - Extension packages (`quadkit-*`) import from `quadkit` and `quadkit-contracts` — never from each other. - Cross-extension communication goes through contracts, the container, providers, and IoC. ### Golden rule > If two or more packages need the same type, protocol, or exception, it lives in `quadkit-contracts`. No exceptions. ### Always - Constructor injection for every dependency. Type-hint the protocol, not `Any`. - Providers own lifecycle: `register(ContainerRegistrarProtocol)` binds, `boot(BootContainerProtocol)` resolves, `shutdown()` tears down. `register()` never resolves. - `Result[T, E]` for expected domain failures (`Ok` / `Err`). Exceptions for infrastructure failures. - Registry-based dispatch instead of `if/elif` chains. Empty `__init__`, `with_defaults()` classmethod. - Absolute imports. `from __future__ import annotations` at the top of every file. - Async I/O. Never block the event loop. Store `asyncio.create_task()` references. - Structured logging via `quadkit.logging.get_logger`. Core config key is `json_format`. Never `print()`. ### Never - Service locator (passing the container into services). - Undocumented cross-package imports that violate the configured package-boundary rules. - `result.unwrap()` without `is_ok()`. - Wrapping infrastructure exceptions in `Result`. - Returning `Result` from `__init__` or lifecycle hooks. - Module-level or class-level singletons. Use container-managed singletons. - Mock/test classes in production `src/` trees. - Business logic on Provider classes. ### Result vs exceptions | Use `Result[T, E]` | Raise | |---|---| | User not found, validation failed | Database connection lost | | Payment declined, insufficient permissions | Serialization bug | | Skill execution failed (expected) | Container resolution failed | | Any failure the caller is expected to handle | Any failure that should propagate | When answering questions about QuadKit, prefer protocols over concrete classes, cite package names with the `quadkit-` prefix, and link to oridecon.dev. ## Notes Notes on building QuadKit. Index: https://oridecon.dev/blog/ · RSS: https://oridecon.dev/blog/rss.xml - [QuadKit 0.0.50 — the eighteen-package line](https://oridecon.dev/blog/quadkit-0-0-50/): The open-core expansion is in the published line — AI, workflow, and notification packages ship with the thirteen at one version, with the guides and agent surfaces to match. - [QK Gatewai — the Community Edition for AI developers](https://oridecon.dev/blog/gatewai-community-edition/): One OpenAI-compatible gateway over free provider tiers, plus a deterministic offline stub — run and test agents locally with zero credentials and no spend. - [From Playground to Builder — rebuilding the QuadKit Builder](https://oridecon.dev/blog/quadkit-builder-rebuild/): The node-canvas workbench that proved one-way codegen is becoming the QuadKit Builder at builder.quadkit.dev — with a trust layer and agent authoring on the roadmap. - [Alpha 0.0.x — what is stable](https://oridecon.dev/blog/alpha-what-is-stable/): The architecture is the pin. Package names and experimental surfaces will still move. Here is what we will not casually rewrite. - [How coding agents should read QuadKit](https://oridecon.dev/blog/how-agents-read-oridecon/): The shortest path from a fresh clone to a change that will pass the import linter — llms.txt, agents.md, contracts, then an example. - [Coming from FastAPI](https://oridecon.dev/blog/coming-from-fastapi/): FastAPI is a great HTTP layer. QuadKit keeps that instinct and puts a composition root around it — you are not starting over. - [I built a Python framework inspired by Laravel](https://oridecon.dev/blog/inspired-by-laravel/): Laravel taught me what developer experience feels like. Here is how those instincts live in Python. - [Why I built QuadKit — consistency for agentic coding](https://oridecon.dev/blog/how-i-built-quadkit/): I kept watching agents produce code that type-checked and still failed. Why consistency had to move from a review step to something the framework enforces. ## Overview - [Oridecon Labs — AI Product Studio](https://oridecon.dev/): Oridecon Labs helps founders and product teams scope, architect, and build useful AI products with technical leadership, coding agents, and QuadKit. - [Oridecon Labs — AI Product Studio](https://oridecon.dev/labs-v2/): Oridecon Labs helps founders and product teams scope, architect, and build useful AI products with technical leadership, coding agents, and QuadKit. - [The AI Friendly Python Framework](https://oridecon.dev/quadkit/): QuadKit is an async-first, contract-driven Python framework with eighteen packages in its 0.0.50 public release. ## Getting Started - [Agent skills](https://oridecon.dev/quadkit/getting-started/agent-skills/): Install the public 10-skill quadkit-skills pack in Claude Code, Cursor, Codex, or OpenCode — and fetch /SKILL.md when you cannot clone. - [Common mistakes](https://oridecon.dev/quadkit/getting-started/common-mistakes/): Fail vs fix — the patches the import linter, type checker, and CLI catch first when an agent generates QuadKit code. - [Configuration](https://oridecon.dev/quadkit/getting-started/configuration/): YAML config, environment profiles, and auto-injection - [Core Concepts](https://oridecon.dev/quadkit/getting-started/core-concepts/): Providers, dependency injection, the Result type, and modules - [Your First App](https://oridecon.dev/quadkit/getting-started/first-app/): Scaffold a web API with the QuadKit CLI and have it serving in a minute. - [For coding agents](https://oridecon.dev/quadkit/getting-started/for-coding-agents/): Read order, repo map, one project tree, and the recipes that pass the import linter — how an agent should learn QuadKit. - [Installation](https://oridecon.dev/quadkit/getting-started/installation/): Install QuadKit and scaffold a project with the CLI. - [Project Structure](https://oridecon.dev/quadkit/getting-started/project-structure/): One project tree that grows — unscoped feature code, then bounded contexts in place. ## Ecosystem - [The Ecosystem](https://oridecon.dev/quadkit/ecosystem/): The QuadKit package catalog, all published at the current PyPI release, grouped by what packages do. - [Adoption Paths](https://oridecon.dev/quadkit/ecosystem/adoption-paths/): Staged adoption guide — start with the CLI, add capability as you grow. - [Choosing Backends](https://oridecon.dev/quadkit/ecosystem/choosing-backends/): Comparison matrices and decision guides for backend choices across the QuadKit catalog. - [Compatibility & Dependencies](https://oridecon.dev/quadkit/ecosystem/compatibility/): Dependency rules, extras, and runtime constraints across the 18-package QuadKit catalog, all published at 0.0.50. ## Fundamentals - [Application Lifecycle](https://oridecon.dev/quadkit/fundamentals/application-lifecycle/): The composition root, AppState machine, and how Application.start() / stop() actually run. - [Architecture](https://oridecon.dev/quadkit/fundamentals/architecture/): How QuadKit's package boundaries are organized and checked. - [Boot Sequence](https://oridecon.dev/quadkit/fundamentals/boot-lifecycle/): register → freeze → boot → shutdown. What each provider hook may do, and what happens when one fails. - [Container Protocols](https://oridecon.dev/quadkit/fundamentals/container-protocols/): Type-safe dependency injection via structural protocols. - [Dependency Injection](https://oridecon.dev/quadkit/fundamentals/dependency-injection/): Mastering Inversion of Control (IoC) and dependency management in QuadKit. - [Modules](https://oridecon.dev/quadkit/fundamentals/modules/): Encapsulating logic and defining public APIs with the QuadKit module system. - [Service Providers](https://oridecon.dev/quadkit/fundamentals/providers/): The engine of QuadKit: Wiring modules together via Providers. - [Result Pattern](https://oridecon.dev/quadkit/fundamentals/result-pattern/): Functional error handling using Result[T, E] for predictable application flow. - [YAML Configuration](https://oridecon.dev/quadkit/fundamentals/yaml-configuration/): Hierarchical configuration with environment interpolation, env-var overrides, and profiles. ## Guides - [Guides](https://oridecon.dev/quadkit/guides/): Task-oriented walkthroughs across QuadKit's package catalog. - [AI Agents](https://oridecon.dev/quadkit/guides/ai-agents/): Build typed agent loops, register @tool functions, coordinate handoffs, and pause for human approval with quadkit-ai-agents. - [AI Integration](https://oridecon.dev/quadkit/guides/ai-integration/): Configure async LLM providers, streaming completions, structured outputs, embeddings, and cost tracking with quadkit-ai-llm. - [MCP Servers & Clients](https://oridecon.dev/quadkit/guides/ai-mcp/): Expose QuadKit tools, resources, and prompts over Model Context Protocol or connect external MCP servers with quadkit-ai-mcp. - [Authentication](https://oridecon.dev/quadkit/guides/authentication/): Identity and access control with quadkit-auth guards, JWT, and RBAC. - [Background Jobs & Tasks](https://oridecon.dev/quadkit/guides/background-jobs/): Run deferred work, scheduled jobs, and distributed queues with quadkit-tasks. - [Caching](https://oridecon.dev/quadkit/guides/caching/): Multi-backend caching with a single protocol — swap in-memory, Redis, or Memcached via config. - [The quadkit CLI](https://oridecon.dev/quadkit/guides/cli/): Scaffold projects, run servers, manage migrations, and inspect your app from one command. - [Contracts, Boundaries, and Extension Points](https://oridecon.dev/quadkit/guides/contracts/): Where contracts live, what counts as a boundary violation, and how to create or upstream a contract. - [Database & Persistence](https://oridecon.dev/quadkit/guides/database/): Async SQL with the repository pattern, domain models, and migrations. - [Deployment & Infrastructure](https://oridecon.dev/quadkit/guides/deployment/): Going from local development to a production QuadKit deployment. - [Event-Driven Architecture](https://oridecon.dev/quadkit/guides/event-driven/): Commands, events, CQRS, and event sourcing with quadkit-events. - [File Storage](https://oridecon.dev/quadkit/guides/file-storage/): Object and blob storage with a single protocol — swap S3, GCS, Azure Blob, R2, or local filesystem via config. - [Outbound HTTP Client](https://oridecon.dev/quadkit/guides/http-client/): Calling external APIs with pooled connections, retries, and observability built in. - [Migrating from FastAPI](https://oridecon.dev/quadkit/guides/migrating-from-fastapi/): You already know FastAPI. This is a map — Starlette routing, Pydantic, OpenAPI — onto QuadKit's composition root. - [Notifications](https://oridecon.dev/quadkit/guides/notifications/): Deliver templated multi-channel notifications across email, SMS, push, Slack, and webhooks with quadkit-notification. - [Observability](https://oridecon.dev/quadkit/guides/observability/): Structured logs, health probes, opt-in tracing, and an incident runbook for a Quadkit service. - [Real-Time & WebSockets](https://oridecon.dev/quadkit/guides/real-time/): Server-sent events, WebSocket connections, and streaming responses. - [Testing Strategies](https://oridecon.dev/quadkit/guides/testing/): Fast, decoupled tests with fakes, test clients, and protocol compliance suites. - [Workflows & Sagas](https://oridecon.dev/quadkit/guides/workflows-sagas/): Orchestrate durable multi-step DAG workflows, state machines, approval gates, and compensating sagas with quadkit-workflow. ## Packages · foundation - [Packages](https://oridecon.dev/quadkit/packages/): The eighteen-package QuadKit catalog, with current and planned PyPI availability, grouped by domain. - [Foundation](https://oridecon.dev/quadkit/packages/foundation/): Core framework and contracts — the two packages every app starts with. - [Core (quadkit)](https://oridecon.dev/quadkit/packages/foundation/quadkit/): Core framework: container, DI, registry, config, logging - [Contracts (quadkit-contracts)](https://oridecon.dev/quadkit/packages/foundation/quadkit-contracts/): Protocols, types, exceptions, domain, Result - [API Reference](https://oridecon.dev/quadkit/packages/foundation/quadkit-contracts/api/): Complete API reference for the quadkit-contracts package. - [Architecture](https://oridecon.dev/quadkit/packages/foundation/quadkit-contracts/docs/architecture/): Architecture for quadkit-contracts - [Configuration](https://oridecon.dev/quadkit/packages/foundation/quadkit-contracts/docs/configuration/): Configuration for quadkit-contracts - [Guide](https://oridecon.dev/quadkit/packages/foundation/quadkit-contracts/docs/guide/): Guide for quadkit-contracts - [How-To Guides](https://oridecon.dev/quadkit/packages/foundation/quadkit-contracts/docs/howtos/): How-To Guides for quadkit-contracts - [Quickstart](https://oridecon.dev/quadkit/packages/foundation/quadkit-contracts/docs/quickstart/): Quickstart for quadkit-contracts - [Troubleshooting](https://oridecon.dev/quadkit/packages/foundation/quadkit-contracts/docs/troubleshooting/): Troubleshooting for quadkit-contracts - [API Reference](https://oridecon.dev/quadkit/packages/foundation/quadkit/api/): Complete API reference for the quadkit package. - [Architecture](https://oridecon.dev/quadkit/packages/foundation/quadkit/docs/architecture/): Architecture for quadkit - [Configuration](https://oridecon.dev/quadkit/packages/foundation/quadkit/docs/configuration/): Configuration for quadkit - [Guide](https://oridecon.dev/quadkit/packages/foundation/quadkit/docs/guide/): Guide for quadkit - [How-To Guides](https://oridecon.dev/quadkit/packages/foundation/quadkit/docs/howtos/): How-To Guides for quadkit - [Plugins (quadkit.plugins)](https://oridecon.dev/quadkit/packages/foundation/quadkit/docs/plugins/): Plugins (quadkit.plugins) — documentation and reference for quadkit in QuadKit. - [Quickstart](https://oridecon.dev/quadkit/packages/foundation/quadkit/docs/quickstart/): Quickstart for quadkit - [Security](https://oridecon.dev/quadkit/packages/foundation/quadkit/docs/security/): Security for quadkit - [Troubleshooting](https://oridecon.dev/quadkit/packages/foundation/quadkit/docs/troubleshooting/): Troubleshooting for quadkit ## Packages · web - [Web](https://oridecon.dev/quadkit/packages/web/): ASGI, controllers, routing, middleware, and OpenAPI. - [HTTP (quadkit-http)](https://oridecon.dev/quadkit/packages/web/quadkit-http/): HTTP client with typed Result errors, retries, timeouts, and a pluggable transport for calling other services — quadkit-http documentation, installation, and architecture in QuadKit. - [API Reference](https://oridecon.dev/quadkit/packages/web/quadkit-http/api/): Complete API reference for the quadkit-http package. - [Architecture](https://oridecon.dev/quadkit/packages/web/quadkit-http/docs/architecture/): Architecture for quadkit-http - [Configuration](https://oridecon.dev/quadkit/packages/web/quadkit-http/docs/configuration/): Configuration for quadkit-http - [Guide](https://oridecon.dev/quadkit/packages/web/quadkit-http/docs/guide/): Guide for quadkit-http - [How-To Guides](https://oridecon.dev/quadkit/packages/web/quadkit-http/docs/howtos/): How-To Guides for quadkit-http - [Quickstart](https://oridecon.dev/quadkit/packages/web/quadkit-http/docs/quickstart/): Quickstart for quadkit-http - [Troubleshooting](https://oridecon.dev/quadkit/packages/web/quadkit-http/docs/troubleshooting/): Troubleshooting for quadkit-http - [Web (quadkit-web)](https://oridecon.dev/quadkit/packages/web/quadkit-web/): ASGI web framework: controllers, routing, middleware - [API Reference](https://oridecon.dev/quadkit/packages/web/quadkit-web/api/): Complete API reference for the quadkit-web package. - [Architecture](https://oridecon.dev/quadkit/packages/web/quadkit-web/docs/architecture/): Architecture for quadkit-web - [Configuration](https://oridecon.dev/quadkit/packages/web/quadkit-web/docs/configuration/): Configuration for quadkit-web - [Guide](https://oridecon.dev/quadkit/packages/web/quadkit-web/docs/guide/): Guide for quadkit-web - [How-To Guides](https://oridecon.dev/quadkit/packages/web/quadkit-web/docs/howtos/): How-To Guides for quadkit-web - [Middleware](https://oridecon.dev/quadkit/packages/web/quadkit-web/docs/middleware/): ASGI middleware stack, ordering, and configuration for quadkit-web in QuadKit. - [Quickstart](https://oridecon.dev/quadkit/packages/web/quadkit-web/docs/quickstart/): Quickstart for quadkit-web - [application.yaml](https://oridecon.dev/quadkit/packages/web/quadkit-web/docs/security/): Security model, hardening, and safe defaults for quadkit-web in QuadKit. - [Troubleshooting](https://oridecon.dev/quadkit/packages/web/quadkit-web/docs/troubleshooting/): Troubleshooting for quadkit-web ## Packages · ai - [AI & Agents](https://oridecon.dev/quadkit/packages/ai/): Model providers, typed agent loops, and Model Context Protocol servers & clients. - [AI Agents (quadkit-ai-agents)](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-agents/): Typed agent loops, `@tool` functions, handoffs, human-in-the-loop checkpoints, and structured execution traces — quadkit-ai-agents documentation, installation, and architecture in QuadKit. - [API Reference](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-agents/api/): Complete API reference for the quadkit-ai-agents package. - [Architecture](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-agents/docs/architecture/): Architecture, contracts, and internal design of quadkit-ai-agents in QuadKit. - [application.yaml](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-agents/docs/configuration/): Configuration options and environment variables for quadkit-ai-agents in QuadKit. - [Guide](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-agents/docs/guide/): Usage guide, patterns, and integration examples for quadkit-ai-agents in QuadKit. - [Howtos](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-agents/docs/howtos/): Howtos — documentation and reference for quadkit-ai-agents in QuadKit. - [Quickstart](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-agents/docs/quickstart/): Quickstart guide to installing, configuring, and running quadkit-ai-agents in QuadKit. - [Register LLMProvider before AgentsProvider](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-agents/docs/troubleshooting/): Troubleshooting guide and error diagnostics for quadkit-ai-agents in QuadKit. - [AI LLM (quadkit-ai-llm)](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-llm/): Unified async LLM layer: streaming completions, structured outputs, embeddings, cost attribution, and multi-provider adapters — quadkit-ai-llm documentation, installation, and architecture in QuadKit. - [API Reference](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-llm/api/): Complete API reference for the quadkit-ai-llm package. - [Architecture](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-llm/docs/architecture/): Architecture, contracts, and internal design of quadkit-ai-llm in QuadKit. - [application.yaml](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-llm/docs/configuration/): Configuration options and environment variables for quadkit-ai-llm in QuadKit. - [Guide](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-llm/docs/guide/): Usage guide, patterns, and integration examples for quadkit-ai-llm in QuadKit. - [Alice — the conversation retains context](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-llm/docs/howtos/): Alice — the conversation retains context — documentation and reference for quadkit-ai-llm in QuadKit. - [Route by criteria](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-llm/docs/providers/): Route by criteria — documentation and reference for quadkit-ai-llm in QuadKit. - [Or with pip](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-llm/docs/quickstart/): Quickstart guide to installing, configuring, and running quadkit-ai-llm in QuadKit. - [No error at startup, but requests fail](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-llm/docs/troubleshooting/): Troubleshooting guide and error diagnostics for quadkit-ai-llm in QuadKit. - [AI MCP (quadkit-ai-mcp)](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-mcp/): Model Context Protocol servers and clients: stdio and HTTP/SSE transports, tool/resource/prompt bridges, and DI wiring — quadkit-ai-mcp documentation, installation, and architecture in QuadKit. - [API Reference](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-mcp/api/): Complete API reference for the quadkit-ai-mcp package. - [Architecture](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-mcp/docs/architecture/): Architecture, contracts, and internal design of quadkit-ai-mcp in QuadKit. - [Configuration](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-mcp/docs/configuration/): Configuration options and environment variables for quadkit-ai-mcp in QuadKit. - [Wiring](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-mcp/docs/guide/): Usage guide, patterns, and integration examples for quadkit-ai-mcp in QuadKit. - [Use the adapter as an MCPToolProviderProtocol implementation](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-mcp/docs/howtos/): Use the adapter as an MCPToolProviderProtocol implementation — documentation and reference for quadkit-ai-mcp in QuadKit. - [Quickstart](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-mcp/docs/quickstart/): Quickstart guide to installing, configuring, and running quadkit-ai-mcp in QuadKit. - [Register missing dependencies](https://oridecon.dev/quadkit/packages/ai/quadkit-ai-mcp/docs/troubleshooting/): Troubleshooting guide and error diagnostics for quadkit-ai-mcp in QuadKit. ## Packages · data - [Data & Storage](https://oridecon.dev/quadkit/packages/data/): Async SQL repositories, multi-backend cache, and blob storage. - [Cache (quadkit-cache)](https://oridecon.dev/quadkit/packages/data/quadkit-cache/): Cache primitives: a Cache protocol, in-memory and Redis backends, stampede-safe single-flight helpers, and TTL invalidation — quadkit-cache documentation, installation, and architecture in QuadKit. - [API Reference](https://oridecon.dev/quadkit/packages/data/quadkit-cache/api/): Complete API reference for the quadkit-cache package. - [Architecture](https://oridecon.dev/quadkit/packages/data/quadkit-cache/docs/architecture/): Architecture for quadkit-cache - [Backends](https://oridecon.dev/quadkit/packages/data/quadkit-cache/docs/backends/): Backends — documentation and reference for quadkit-cache in QuadKit. - [Configuration](https://oridecon.dev/quadkit/packages/data/quadkit-cache/docs/configuration/): Configuration for quadkit-cache - [Guide](https://oridecon.dev/quadkit/packages/data/quadkit-cache/docs/guide/): Guide for quadkit-cache - [How-To Guides](https://oridecon.dev/quadkit/packages/data/quadkit-cache/docs/howtos/): How-To Guides for quadkit-cache - [Quickstart](https://oridecon.dev/quadkit/packages/data/quadkit-cache/docs/quickstart/): Quickstart for quadkit-cache - [Troubleshooting](https://oridecon.dev/quadkit/packages/data/quadkit-cache/docs/troubleshooting/): Troubleshooting for quadkit-cache - [SQL (quadkit-sql)](https://oridecon.dev/quadkit/packages/data/quadkit-sql/): Async SQLAlchemy ORM: repositories, unit-of-work - [API Reference](https://oridecon.dev/quadkit/packages/data/quadkit-sql/api/): Complete API reference for the quadkit-sql package. - [Architecture](https://oridecon.dev/quadkit/packages/data/quadkit-sql/docs/architecture/): Architecture for quadkit-sql - [application.yaml](https://oridecon.dev/quadkit/packages/data/quadkit-sql/docs/backends/): application.yaml — documentation and reference for quadkit-sql in QuadKit. - [Configuration](https://oridecon.dev/quadkit/packages/data/quadkit-sql/docs/configuration/): Configuration for quadkit-sql - [Guide](https://oridecon.dev/quadkit/packages/data/quadkit-sql/docs/guide/): Guide for quadkit-sql - [How-To Guides](https://oridecon.dev/quadkit/packages/data/quadkit-sql/docs/howtos/): How-To Guides for quadkit-sql - [Quickstart](https://oridecon.dev/quadkit/packages/data/quadkit-sql/docs/quickstart/): Quickstart for quadkit-sql - [Troubleshooting](https://oridecon.dev/quadkit/packages/data/quadkit-sql/docs/troubleshooting/): Troubleshooting for quadkit-sql - [Storage (quadkit-storage)](https://oridecon.dev/quadkit/packages/data/quadkit-storage/): Artifact storage: a BlobStore protocol, local and S3 backends, content-addressed keys, and signed URL helpers — quadkit-storage documentation, installation, and architecture in QuadKit. - [API Reference](https://oridecon.dev/quadkit/packages/data/quadkit-storage/api/): Complete API reference for the quadkit-storage package. - [Architecture](https://oridecon.dev/quadkit/packages/data/quadkit-storage/docs/architecture/): Architecture for quadkit-storage - [Backends](https://oridecon.dev/quadkit/packages/data/quadkit-storage/docs/backends/): Backends — documentation and reference for quadkit-storage in QuadKit. - [Configuration](https://oridecon.dev/quadkit/packages/data/quadkit-storage/docs/configuration/): Configuration for quadkit-storage - [Guide](https://oridecon.dev/quadkit/packages/data/quadkit-storage/docs/guide/): Guide for quadkit-storage - [How-To Guides](https://oridecon.dev/quadkit/packages/data/quadkit-storage/docs/howtos/): How-To Guides for quadkit-storage - [Quickstart](https://oridecon.dev/quadkit/packages/data/quadkit-storage/docs/quickstart/): Quickstart for quadkit-storage - [Troubleshooting](https://oridecon.dev/quadkit/packages/data/quadkit-storage/docs/troubleshooting/): Troubleshooting for quadkit-storage ## Packages · events - [Events & Notifications](https://oridecon.dev/quadkit/packages/events/): Domain events, outbox publishing, and multi-channel notifications. - [Events (quadkit-events)](https://oridecon.dev/quadkit/packages/events/quadkit-events/): CQRS, Event Sourcing, EventBus, sagas - [API Reference](https://oridecon.dev/quadkit/packages/events/quadkit-events/api/): Complete API reference for the quadkit-events package. - [Architecture](https://oridecon.dev/quadkit/packages/events/quadkit-events/docs/architecture/): Architecture for quadkit-events - [Atomic inbox intent from a generated use case](https://oridecon.dev/quadkit/packages/events/quadkit-events/docs/atomic-inbox-generation/): Atomic inbox intent from a generated use case — documentation and reference for quadkit-events in QuadKit. - [Configuration](https://oridecon.dev/quadkit/packages/events/quadkit-events/docs/configuration/): Configuration for quadkit-events - [Guide](https://oridecon.dev/quadkit/packages/events/quadkit-events/docs/guide/): Guide for quadkit-events - [How-To Guides](https://oridecon.dev/quadkit/packages/events/quadkit-events/docs/howtos/): How-To Guides for quadkit-events - [SQLite outbox staging and relay](https://oridecon.dev/quadkit/packages/events/quadkit-events/docs/outbox/): SQLite outbox staging and relay — documentation and reference for quadkit-events in QuadKit. - [In ProjectionProtocol.apply():](https://oridecon.dev/quadkit/packages/events/quadkit-events/docs/projections/): In ProjectionProtocol.apply() — documentation and reference for quadkit-events in QuadKit. - [Quickstart](https://oridecon.dev/quadkit/packages/events/quadkit-events/docs/quickstart/): Quickstart for quadkit-events - [Usage](https://oridecon.dev/quadkit/packages/events/quadkit-events/docs/sagas/): Usage — documentation and reference for quadkit-events in QuadKit. - [Troubleshooting](https://oridecon.dev/quadkit/packages/events/quadkit-events/docs/troubleshooting/): Troubleshooting for quadkit-events - [Notification (quadkit-notification)](https://oridecon.dev/quadkit/packages/events/quadkit-notification/): Push notifications (FCM, APNs, WebPush) - [API Reference](https://oridecon.dev/quadkit/packages/events/quadkit-notification/api/): Complete API reference for the quadkit-notification package. - [Architecture](https://oridecon.dev/quadkit/packages/events/quadkit-notification/docs/architecture/): Architecture for quadkit-notification - [All operations work identically — no external dependencies](https://oridecon.dev/quadkit/packages/events/quadkit-notification/docs/channels/): All operations work identically — no external dependencies — documentation and reference for quadkit-notification in QuadKit. - [Configuration](https://oridecon.dev/quadkit/packages/events/quadkit-notification/docs/configuration/): Configuration for quadkit-notification - [Guide](https://oridecon.dev/quadkit/packages/events/quadkit-notification/docs/guide/): Guide for quadkit-notification - [How-To Guides](https://oridecon.dev/quadkit/packages/events/quadkit-notification/docs/howtos/): How-To Guides for quadkit-notification - [Trusted, retry-safe local inbox delivery](https://oridecon.dev/quadkit/packages/events/quadkit-notification/docs/inbox-delivery/): Trusted, retry-safe local inbox delivery — documentation and reference for quadkit-notification in QuadKit. - [Quickstart](https://oridecon.dev/quadkit/packages/events/quadkit-notification/docs/quickstart/): Quickstart for quadkit-notification - [Troubleshooting](https://oridecon.dev/quadkit/packages/events/quadkit-notification/docs/troubleshooting/): Troubleshooting for quadkit-notification ## Packages · infra - [Infrastructure & Workflows](https://oridecon.dev/quadkit/packages/infra/): Background tasks, durable DAG workflows, sagas, and operational observability. - [Monitor (quadkit-monitor)](https://oridecon.dev/quadkit/packages/infra/quadkit-monitor/): Metrics, health checks, structured logging - [API Reference](https://oridecon.dev/quadkit/packages/infra/quadkit-monitor/api/): Complete API reference for the quadkit-monitor package. - [Architecture](https://oridecon.dev/quadkit/packages/infra/quadkit-monitor/docs/architecture/): Architecture for quadkit-monitor - [Configuration](https://oridecon.dev/quadkit/packages/infra/quadkit-monitor/docs/configuration/): Configuration for quadkit-monitor - [Guide](https://oridecon.dev/quadkit/packages/infra/quadkit-monitor/docs/guide/): Guide for quadkit-monitor - [How-To Guides](https://oridecon.dev/quadkit/packages/infra/quadkit-monitor/docs/howtos/): How-To Guides for quadkit-monitor - [... work ...](https://oridecon.dev/quadkit/packages/infra/quadkit-monitor/docs/metrics/): ... work ... — documentation and reference for quadkit-monitor in QuadKit. - [Quickstart](https://oridecon.dev/quadkit/packages/infra/quadkit-monitor/docs/quickstart/): Quickstart for quadkit-monitor - [Troubleshooting](https://oridecon.dev/quadkit/packages/infra/quadkit-monitor/docs/troubleshooting/): Troubleshooting for quadkit-monitor - [Tasks (quadkit-tasks)](https://oridecon.dev/quadkit/packages/infra/quadkit-tasks/): Background tasks: a queue, worker pools, retries with backoff, schedules, and an HTTP console for observing runs — quadkit-tasks documentation, installation, and architecture in QuadKit. - [API Reference](https://oridecon.dev/quadkit/packages/infra/quadkit-tasks/api/): Complete API reference for the quadkit-tasks package. - [Architecture](https://oridecon.dev/quadkit/packages/infra/quadkit-tasks/docs/architecture/): Architecture for quadkit-tasks - [Backends](https://oridecon.dev/quadkit/packages/infra/quadkit-tasks/docs/backends/): Backends — documentation and reference for quadkit-tasks in QuadKit. - [Configuration](https://oridecon.dev/quadkit/packages/infra/quadkit-tasks/docs/configuration/): Configuration for quadkit-tasks - [Guide](https://oridecon.dev/quadkit/packages/infra/quadkit-tasks/docs/guide/): Guide for quadkit-tasks - [How-To Guides](https://oridecon.dev/quadkit/packages/infra/quadkit-tasks/docs/howtos/): How-To Guides for quadkit-tasks - [Quickstart](https://oridecon.dev/quadkit/packages/infra/quadkit-tasks/docs/quickstart/): Quickstart for quadkit-tasks - [Task Registration Contract](https://oridecon.dev/quadkit/packages/infra/quadkit-tasks/docs/registration/): Task Registration Contract — documentation and reference for quadkit-tasks in QuadKit. - [Troubleshooting](https://oridecon.dev/quadkit/packages/infra/quadkit-tasks/docs/troubleshooting/): Troubleshooting for quadkit-tasks - [Workflow (quadkit-workflow)](https://oridecon.dev/quadkit/packages/infra/quadkit-workflow/): Durable workflows, DAG pipelines, state machines, human approval gates, and compensating sagas with checkpoint/resume — quadkit-workflow documentation, installation, and architecture in QuadKit. - [API Reference](https://oridecon.dev/quadkit/packages/infra/quadkit-workflow/api/): Complete API reference for the quadkit-workflow package. - [Architecture](https://oridecon.dev/quadkit/packages/infra/quadkit-workflow/docs/architecture/): Architecture for quadkit-workflow - [Configuration](https://oridecon.dev/quadkit/packages/infra/quadkit-workflow/docs/configuration/): Configuration for quadkit-workflow - [Guide](https://oridecon.dev/quadkit/packages/infra/quadkit-workflow/docs/guide/): Guide for quadkit-workflow - [How-To Guides](https://oridecon.dev/quadkit/packages/infra/quadkit-workflow/docs/howtos/): How-To Guides for quadkit-workflow - [Database Migrations for quadkit-workflow](https://oridecon.dev/quadkit/packages/infra/quadkit-workflow/docs/migration-reference/): Database Migrations for quadkit-workflow — documentation and reference for quadkit-workflow in QuadKit. - [Quickstart](https://oridecon.dev/quadkit/packages/infra/quadkit-workflow/docs/quickstart/): Quickstart for quadkit-workflow - [Saga Selection Guide](https://oridecon.dev/quadkit/packages/infra/quadkit-workflow/docs/saga-selection/): Saga Selection Guide — documentation and reference for quadkit-workflow in QuadKit. - [Sagas](https://oridecon.dev/quadkit/packages/infra/quadkit-workflow/docs/sagas/): Sagas — documentation and reference for quadkit-workflow in QuadKit. - [Troubleshooting](https://oridecon.dev/quadkit/packages/infra/quadkit-workflow/docs/troubleshooting/): Troubleshooting for quadkit-workflow ## Packages · security - [Security](https://oridecon.dev/quadkit/packages/security/): Authentication, authorization, RBAC, MFA, and API keys. - [Auth (quadkit-auth)](https://oridecon.dev/quadkit/packages/security/quadkit-auth/): Authentication and authorization: API keys, MFA, RBAC, session stores, and login flows wired through the DI container — quadkit-auth documentation, installation, and architecture in QuadKit. - [API Reference](https://oridecon.dev/quadkit/packages/security/quadkit-auth/api/): Complete API reference for the quadkit-auth package. - [Architecture](https://oridecon.dev/quadkit/packages/security/quadkit-auth/docs/architecture/): Architecture for quadkit-auth - [Configuration](https://oridecon.dev/quadkit/packages/security/quadkit-auth/docs/configuration/): Configuration for quadkit-auth - [Guide](https://oridecon.dev/quadkit/packages/security/quadkit-auth/docs/guide/): Guide for quadkit-auth - [How-To Guides](https://oridecon.dev/quadkit/packages/security/quadkit-auth/docs/howtos/): How-To Guides for quadkit-auth - [Quickstart](https://oridecon.dev/quadkit/packages/security/quadkit-auth/docs/quickstart/): Quickstart for quadkit-auth - [application.yaml](https://oridecon.dev/quadkit/packages/security/quadkit-auth/docs/security/): Security model, hardening, and safe defaults for quadkit-auth in QuadKit. - [Explicit encrypted SQLite session storage](https://oridecon.dev/quadkit/packages/security/quadkit-auth/docs/sql_sessions/): Explicit encrypted SQLite session storage — documentation and reference for quadkit-auth in QuadKit. - [Troubleshooting](https://oridecon.dev/quadkit/packages/security/quadkit-auth/docs/troubleshooting/): Troubleshooting for quadkit-auth ## Packages · utilities - [Tooling](https://oridecon.dev/quadkit/packages/utilities/): The testing kit and the command-line driver for every Quadkit project. - [CLI (quadkit-cli)](https://oridecon.dev/quadkit/packages/utilities/quadkit-cli/): The quadkit command line: project scaffolding, generators, a smart runner, and admin commands — quadkit-cli documentation, installation, and architecture in QuadKit. - [API Reference](https://oridecon.dev/quadkit/packages/utilities/quadkit-cli/api/): Complete API reference for the quadkit-cli package. - [Architecture](https://oridecon.dev/quadkit/packages/utilities/quadkit-cli/docs/architecture/): Architecture, contracts, and internal design of quadkit-cli in QuadKit. - [Commands](https://oridecon.dev/quadkit/packages/utilities/quadkit-cli/docs/commands/): Commands — documentation and reference for quadkit-cli in QuadKit. - [Configuration](https://oridecon.dev/quadkit/packages/utilities/quadkit-cli/docs/configuration/): Configuration options and environment variables for quadkit-cli in QuadKit. - [Guide](https://oridecon.dev/quadkit/packages/utilities/quadkit-cli/docs/guide/): Usage guide, patterns, and integration examples for quadkit-cli in QuadKit. - [How-To Guides](https://oridecon.dev/quadkit/packages/utilities/quadkit-cli/docs/howtos/): Howtos — documentation and reference for quadkit-cli in QuadKit. - [Project layout](https://oridecon.dev/quadkit/packages/utilities/quadkit-cli/docs/project_layout/): One project tree — unscoped feature code, shared cross-cutting packages, and bounded contexts grown in place. - [Quickstart](https://oridecon.dev/quadkit/packages/utilities/quadkit-cli/docs/quickstart/): Quickstart guide to installing, configuring, and running quadkit-cli in QuadKit. - [Troubleshooting](https://oridecon.dev/quadkit/packages/utilities/quadkit-cli/docs/troubleshooting/): Troubleshooting guide and error diagnostics for quadkit-cli in QuadKit. - [Testing (quadkit-testing)](https://oridecon.dev/quadkit/packages/utilities/quadkit-testing/): Test harnesses, fakes, and fixtures that boot the real application in-process — quadkit-testing documentation, installation, and architecture in QuadKit. - [API Reference](https://oridecon.dev/quadkit/packages/utilities/quadkit-testing/api/): Complete API reference for the quadkit-testing package. - [Architecture](https://oridecon.dev/quadkit/packages/utilities/quadkit-testing/docs/architecture/): Architecture for quadkit-testing - [Run with: pytest tests/ --verbose](https://oridecon.dev/quadkit/packages/utilities/quadkit-testing/docs/compliance/): Run with: pytest tests/ --verbose — documentation and reference for quadkit-testing in QuadKit. - [Configuration](https://oridecon.dev/quadkit/packages/utilities/quadkit-testing/docs/configuration/): Configuration for quadkit-testing - [Guide](https://oridecon.dev/quadkit/packages/utilities/quadkit-testing/docs/guide/): Guide for quadkit-testing - [How-To Guides](https://oridecon.dev/quadkit/packages/utilities/quadkit-testing/docs/howtos/): How-To Guides for quadkit-testing - [Quickstart](https://oridecon.dev/quadkit/packages/utilities/quadkit-testing/docs/quickstart/): Quickstart for quadkit-testing - [Troubleshooting](https://oridecon.dev/quadkit/packages/utilities/quadkit-testing/docs/troubleshooting/): Troubleshooting for quadkit-testing ## Reference - [CLI Reference](https://oridecon.dev/quadkit/reference/cli/): Every command the public quadkit CLI ships — scaffolding, generators, the runner, and project commands. - [Environment Variables](https://oridecon.dev/quadkit/reference/env-vars/): Complete registry of QK_QUADKIT__* environment variables across all 18 public QuadKit packages. - [Error Codes](https://oridecon.dev/quadkit/reference/errors/): Canonical QK-- error-code registry across all 18 public QuadKit packages. ## Changelog - [Changelog](https://oridecon.dev/quadkit/changelog/): What ships in the Quadkit 0.0 line, written for humans. For the full API reference, follow the Reference section or browse the packages documentation.