Skip to content

Examples

README.md

QuadKit Public Examples

Runnable demo apps built across QuadKit's 18-package catalog — all published in 0.0.50 — REST APIs, WebSockets, multi-provider LLMs, tool-calling AI agents, MCP servers, durable workflows, notifications, SQL repositories, caching, blob storage, authentication, background tasks, and observability. Pick any app on the left, then inspect any file in its tree.


What's here

The examples cover the full eighteen-package catalog, all on PyPI in 0.0.50 — including quadkit-ai-llm, quadkit-ai-agents, quadkit-ai-mcp, quadkit-workflow, and quadkit-notification. Examples run offline with deterministic local backends by default.

For internal platform demos covering RAG pipelines, vector stores, graph explorers, multi-tenancy, resilience, message brokers, and GraphQL, see Extended Examples.

Quick start

cd examples/<example-name>
PYTHONPATH=src uv run python -m <module_name>

Every app boots on its own port (or via quadkit run). The example-hub console embeds the web fleet on a single port (http://127.0.0.1:7000).

Canonical layout

All examples follow the same QuadKit project structure:

src/<module>/
  app.py          # Composition root (modules + providers)
  main.py         # Async server entry point
  config.py       # Typed BaseConfig sections
  controllers/    # HTTP / WebSocket / MCP handlers
  di/             # Provider registration & boot wiring
  domains/        # Domain models & value objects
  services/       # Business logic
application.yaml  # Complete typed configuration reference
Explorer 1 file
examples