Skip to content
QuadKit Python Framework

Guides

Each guide walks through one real problem end to end. The 0.0.50 public release contains eighteen packages. New to QuadKit? Start with First Application.

Walkthroughs

Section titled “Walkthroughs”

Core, Web & Security

Section titled “Core, Web & Security”
  • CLI Usage (quadkit-cli) — Scaffold a project, generate controllers and providers, and run in dev mode
  • Testing (quadkit-testing) — Boot the real application in-process, fake infrastructure, and assert on Result
  • Authentication (quadkit-auth) — Argon2id password hashing, JWT/opaque sessions, RBAC, MFA, and API keys
  • Outbound HTTP (quadkit-http) — Typed async HTTP client with connection pooling, SSRF protection, and Result return values
  • Real-Time (quadkit-web) — WebSockets and Server-Sent Events on the web module
  • Contracts (quadkit-contracts) — program against shared Protocol definitions so implementations stay swappable

AI & Agents

Section titled “AI & Agents”
  • AI Integration (quadkit-ai-llm) — Multi-provider async LLM clients, routing, streaming, structured outputs, and cost tracking
  • AI Agents (quadkit-ai-agents) — Autonomous tool-calling agents with ReAct and plan-and-execute strategies
  • MCP Servers & Clients (quadkit-ai-mcp) — Expose @tool, @resource, and @prompt handlers over Model Context Protocol JSON-RPC, stdio, and SSE

Data, Events & Infrastructure

Section titled “Data, Events & Infrastructure”
  • Database & SQL (quadkit-sql) — Async repositories, units of work, and migrations across PostgreSQL, MySQL, and SQLite
  • Caching (quadkit-cache) — Cache-aside reads, stampede protection, namespaces, and Redis/Memcached/in-memory backends
  • File Storage (quadkit-storage) — Async blob storage across local filesystem, S3, GCS, and Azure Blob
  • Event-Driven (quadkit-events) — Domain event bus, event sourcing, projections, transactional outbox, and sagas
  • Notifications (quadkit-notification) — Transactional email, SMS, push, Slack/WhatsApp channels, templates, and in-app inbox
  • Background Jobs (quadkit-tasks) — Priority queues, cron/interval schedules, retries, and dead-letter handling
  • Workflows & Sagas (quadkit-workflow) — Durable multi-step workflows, human-in-the-loop checkpoints, and compensating sagas
  • Observability (quadkit-monitor) — Health checks, Prometheus metrics, and OpenTelemetry tracing

Operations & Migration

Section titled “Operations & Migration”
  • Deployment — Health probes, QK_* configuration, ASGI workers, and container images
  • Migrating from FastAPI — Translate routers, Depends(), HTTPException, and lifespan hooks one concept at a time

Package How-Tos

Section titled “Package How-Tos”

Every published package also carries focused, recipe-level answers on its own How-tos tab: