Skip to content

Examples

README.md

Core Package Examples

Runnable demo apps built with QuadKit's core packages — each one is a living tutorial for a specific capability: REST APIs, WebSockets, background workers, database tasks, multi-tenancy, auth, and AI assistants. Pick one on the left, then open any file in the tree.


What's here

These examples use only the core open-source packages (quadkit-core, quadkit-web, quadkit-cache, etc.). For the full internal app catalog — 42+ demos covering AI, events, workflows, and infrastructure — see Extended Examples.

Quick start

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

Every app boots on its own port. The example-hub console embeds them all on a single port (http://127.0.0.1:7000).

Canonical layout

All examples follow the same QuadKit project structure:

src/<module>/
  app.py          # Application factory
  main.py         # Boot entry point
  config.py       # Typed configuration sections
  controllers/    # HTTP / WebSocket handlers
  di/             # Provider registration (container wiring)
  services/       # Business logic
application.yaml  # Configuration tree
Explorer 1 file
examples