About

I'm Kevin Meinon, a freelance backend engineer specialising in Python and production-grade API systems — primarily FastAPI, but equally at home with Flask and Django depending on what the project calls for.

This template is a living showcase of the architecture patterns and engineering standards I bring to every engagement — not boilerplate to fill in, but a reference for what production-ready actually looks like.

What I build:

• High-throughput REST & async APIs with clean domain separation
• End-to-end CI pipelines with strict quality gates (lint, types, coverage)
• Cloud-portable infrastructure baselines (AWS / Azure / GCP)
• Systems that are easy for your team to own after I'm done

If your team needs a backend that ships fast and holds up — let's talk.

What this demonstrates

Tech stack

• Runtime: Python 3.14
• Framework: FastAPI + Pydantic v2 · Flask · Django
• Database: PostgreSQL · SQLAlchemy async · asyncpg
• Tooling: uv · Ruff · Ty · pytest · tox
• Infrastructure: Docker · Docker Compose · Terraform (AWS / Azure / GCP)
• CI/CD: GitHub Actions

The FastAPI layer is intentionally thin and architecturally isolated — swapping it for Flask or Django is a configuration change, not a rewrite.

API surface

GET    /api/v1/health                       # public
GET    /api/v1/metrics                      # public
POST   /api/v1/documents/analyze            # requires X-API-Key
POST   /api/v1/documents                    # requires X-API-Key
GET    /api/v1/documents                    # requires X-API-Key
GET    /api/v1/documents/{document_id}      # requires X-API-Key
PUT    /api/v1/documents/{document_id}      # requires X-API-Key
DELETE /api/v1/documents/{document_id}      # requires X-API-Key

Local development

uv sync --all-groups
uv run uvicorn fastapi_production_template.main:app --reload

curl -H "X-API-Key: dev-api-key" http://localhost:8000/api/v1/documents

Quality gates

uv run pytest          # tests + coverage
uv run ruff check .    # linting
uv run ty check .      # type checking
uv run tox             # full gate

uv run pre-commit install
uv run pre-commit run --all-files

Docker

docker compose up --build

# Dev profile with hot reload
docker compose --profile dev up --build --watch api-dev postgres

Terraform

terraform -chdir=infra/terraform-aws   init && validate
terraform -chdir=infra/terraform-azure init && validate
terraform -chdir=infra/terraform-gcp   init && validate