Python web services — Flask & FastAPI

This example complements the Python language guide and the step-by-step tutorial.

What you will demonstrate

• A read-only plan for a small API change (akmon --plan).
• A single headless implementation pass (akmon --yes) with tests.
• AKMON.md steering for framework-specific layout (app factory vs main.py, router modules, etc.).

Flask — readiness endpoint

Context in AKMON.md: Document how the app is created (create_app), where config lives, and the test command (pytest).

akmon --plan --task "Add GET /api/ready that returns {status: ok} and optionally verifies DB with existing engine"
akmon --yes --task "Implement /api/ready per the latest plan; use application factory pattern already in repo"
pytest

FastAPI — authenticated route

Context: List dependencies used for auth (e.g. OAuth2PasswordBearer, custom get_current_user).

akmon --plan --task "Add GET /users/me using existing JWT dependency; specify files to edit"
akmon --yes --task "Implement /users/me; mirror error handling from similar routes; add async tests"
pytest

Tips

• Put one test command in Conventions so every session agrees on verification.
• If you use OpenAPI, mention where the spec is generated—helps the agent avoid duplicate route definitions.
• For long handlers, prefer plan mode first so file boundaries are explicit before writes.

See also: Headless mode, Security model.