diff --git a/examples/fastapi-simple-docker-pip/.dockerignore b/examples/fastapi-simple-docker-pip/.dockerignore
new file mode 100644
index 0000000..4f719c5
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/.dockerignore
@@ -0,0 +1,8 @@
+node_modules
+.git
+.github
+build
+.devcontainer
+.serverless
+.venv
+.vscode
diff --git a/examples/fastapi-simple-docker-pip/.env.example b/examples/fastapi-simple-docker-pip/.env.example
new file mode 100644
index 0000000..47fc86a
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/.env.example
@@ -0,0 +1,7 @@
+# For Email
+EMAIL_FROM_EMAIL=admin@admin.com
+EMAIL_SMTP_HOST=smtp.gmail.com
+EMAIL_SMTP_PASSWORD=password
+EMAIL_SMTP_PORT=587
+EMAIL_SMTP_USER=user
+EMAIL_TO_EMAIL=admin@admin.com
diff --git a/examples/fastapi-simple-docker-pip/.flake8 b/examples/fastapi-simple-docker-pip/.flake8
new file mode 100644
index 0000000..47ef966
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/.flake8
@@ -0,0 +1,14 @@
+[flake8]
+max-line-length = 100
+max-complexity = 18
+select =
+    "B",  # Bugbear
+    "C",  # Cyclomatic complexity
+    "E",  # PEP8 errors
+    "F",  # PyFlakes
+    "W",  # PEP8 warnings
+    "T4",  # Flake8 plugins that check typing
+    "B9",  # Bugbear
+#require-plugins =
+#    "flake8-bugbear",
+#    "flake8-black",
diff --git a/examples/fastapi-simple-docker-pip/.github/CODEOWNERS b/examples/fastapi-simple-docker-pip/.github/CODEOWNERS
new file mode 100644
index 0000000..68fe033
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/.github/CODEOWNERS
@@ -0,0 +1 @@
+* @ulises-jeremias @rpmolina
\ No newline at end of file
diff --git a/examples/fastapi-simple-docker-pip/.github/CODE_OF_CONDUCT.md b/examples/fastapi-simple-docker-pip/.github/CODE_OF_CONDUCT.md
new file mode 100644
index 0000000..e64edd1
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/.github/CODE_OF_CONDUCT.md
@@ -0,0 +1,8 @@
+# Code of Conduct
+
+This code of conduct is derived from the Ruby code of conduct. This document provides community guidelines for a safe, respectful, productive, and collaborative place for any person who is willing to contribute to this community. It applies to all “collaborative space”, which is defined as community communications channels. Any violations of the code of conduct may be reported by contacting one or more of the project maintainers either directly.
+
+- Participants will be tolerant of opposing views.
+- Participants must ensure that their language and actions are free of personal attacks and disparaging personal remarks.
+- When interpreting the words and actions of others, participants should always assume good intentions.
+- Behaviour that the project maintainers consider to be harassment will not be tolerated.
diff --git a/examples/fastapi-simple-docker-pip/.github/ISSUE_TEMPLATE/bug-report.yml b/examples/fastapi-simple-docker-pip/.github/ISSUE_TEMPLATE/bug-report.yml
new file mode 100644
index 0000000..3dec867
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/.github/ISSUE_TEMPLATE/bug-report.yml
@@ -0,0 +1,77 @@
+---
+name: "🐛 Bug Report"
+description: Report a bug
+title: "(short issue description)"
+labels: [bug]
+assignees: []
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the bug
+      description: What is the problem? A clear and concise description of the bug.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: |
+        What did you expect to happen?
+    validations:
+      required: true
+  - type: textarea
+    id: current
+    attributes:
+      label: Current Behavior
+      description: |
+        What actually happened?
+
+        Please include full errors, uncaught exceptions, stack traces, and relevant logs.
+        If service/functions responses are relevant, please include wire logs.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction Steps
+      description: |
+        Provide a self-contained, concise snippet of code that can be used to reproduce the issue.
+        For more complex issues provide a repo with the smallest sample that reproduces the bug.
+
+        Avoid including business logic or unrelated code, it makes diagnosis more difficult.
+        The code sample should be an SSCCE. See http://sscce.org/ for details.
+        In short, please provide a code sample that we can copy/paste, run and reproduce.
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Possible Solution
+      description: |
+        Suggest a fix/reason for the bug
+    validations:
+      required: false
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Information/Context
+      description: |
+        Anything else that might be relevant for troubleshooting this bug.
+        Providing context helps us come up with a solution that is most useful in the real world.
+    validations:
+      required: false
+  - type: input
+    id: version
+    attributes:
+      label: Version used
+      description: |
+        Please provide the version of the repository or tool you are using.
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: Environment details (OS name and version, etc.)
+    validations:
+      required: true
diff --git a/examples/fastapi-simple-docker-pip/.github/ISSUE_TEMPLATE/config.yml b/examples/fastapi-simple-docker-pip/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000..9205c2e
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,6 @@
+---
+blank_issues_enabled: false
+contact_links:
+  - name: 💬 General Question
+    url: https://github.com/nanlabs/aws-glue-etl-boilerplate/discussions/categories/q-a
+    about: Please ask and answer questions as a discussion thread
diff --git a/examples/fastapi-simple-docker-pip/.github/ISSUE_TEMPLATE/documentation.yml b/examples/fastapi-simple-docker-pip/.github/ISSUE_TEMPLATE/documentation.yml
new file mode 100644
index 0000000..861e8d1
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/.github/ISSUE_TEMPLATE/documentation.yml
@@ -0,0 +1,23 @@
+---
+name: "📕 Documentation Issue"
+description: Report an issue in the Reference documentation or Developer Guide
+title: "(short issue description)"
+labels: [documentation]
+assignees: []
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the issue
+      description: A clear and concise description of the issue.
+    validations:
+      required: true
+
+  - type: textarea
+    id: links
+    attributes:
+      label: Links
+      description: |
+        Include links to affected documentation page(s).
+    validations:
+      required: true
diff --git a/examples/fastapi-simple-docker-pip/.github/ISSUE_TEMPLATE/feature-request.yml b/examples/fastapi-simple-docker-pip/.github/ISSUE_TEMPLATE/feature-request.yml
new file mode 100644
index 0000000..7025908
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/.github/ISSUE_TEMPLATE/feature-request.yml
@@ -0,0 +1,63 @@
+---
+name: 🚀 Feature Request
+description: Suggest an idea for this project
+title: "(short issue description)"
+labels: [feature-request]
+assignees: []
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the feature
+      description: A clear and concise description of the feature you are proposing.
+    validations:
+      required: true
+  - type: textarea
+    id: use-case
+    attributes:
+      label: Use Case
+      description: |
+        Why do you need this feature? For example: "I'm always frustrated when..."
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: |
+        Suggest how to implement the addition or change.
+        Please include prototype/workaround/sketch/reference implementation.
+    validations:
+      required: false
+  - type: textarea
+    id: other
+    attributes:
+      label: Other Information
+      description: |
+        Any alternative solutions or features you considered, a more detailed explanation,
+        stack traces, related issues, links for context, etc.
+    validations:
+      required: false
+  - type: checkboxes
+    id: ack
+    attributes:
+      label: Acknowledgements
+      options:
+        - label: I may be able to implement this feature request
+          required: false
+        - label: This feature might incur a breaking change
+          required: false
+  - type: input
+    id: version
+    attributes:
+      label: Version used
+      description: |
+        Please provide the version of the repository or tool you are using.
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: Environment details (OS name and version, etc.)
+    validations:
+      required: true
diff --git a/examples/fastapi-simple-docker-pip/.github/PULL_REQUEST_TEMPLATE.md b/examples/fastapi-simple-docker-pip/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 0000000..c9c7a26
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,29 @@
+# What's this PR do?
+
+_Summary of changes in this PR or what it accomplishes._
+
+<!--
+Please title your PR as follows: `feature: fix foo bar`.
+Always start with the thing you are fixing, then describe the fix.
+Don't use past tense (e.g. "fixed foo bar").
+
+Explain what your PR does and why.
+
+If you are adding a new function, please document it and add tests:
+
+```python
+code you added/updated
+```
+
+If you are fixing a bug, please add a test that covers it.
+
+Before submitting a PR, please:
+  - specify the command to execute or steps to follow to know that the problem was solved
+
+We try to process PRs as soon as possible. They should be handled within 24 hours.
+
+Applying labels to PRs is not needed.
+
+Thanks a lot for your contribution!
+
+->
diff --git a/examples/fastapi-simple-docker-pip/.github/dependabot.yml b/examples/fastapi-simple-docker-pip/.github/dependabot.yml
new file mode 100644
index 0000000..a5d4c86
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/.github/dependabot.yml
@@ -0,0 +1,12 @@
+---
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"
diff --git a/examples/fastapi-simple-docker-pip/.github/workflows/lint.yml b/examples/fastapi-simple-docker-pip/.github/workflows/lint.yml
new file mode 100644
index 0000000..3ce2e0b
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/.github/workflows/lint.yml
@@ -0,0 +1,79 @@
+---
+name: Super Linter
+
+on:
+  push:
+    branches:
+      - main
+
+  pull_request:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Lint Code Base
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+      actions: read
+      checks: read
+      statuses: write
+    steps:
+      - name: Checkout
+        id: checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python, including cache for pipenv virtual environment
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: .python-version
+          cache: pipenv
+
+      - name: Install pipenv
+        run: |
+          pip install --upgrade pip
+          pip install pipenv
+
+      - name: Install project dependencies
+        run: pipenv install --deploy --dev
+
+      - name: Get virtual environment path
+        id: get-venv-path
+        run: echo "venv-path=$(pipenv --venv)" >> "$GITHUB_OUTPUT"
+
+      - name: Copy python dependencies
+        run: |
+          cp -r "${{ steps.get-venv-path.outputs.venv-path }}" \
+          /home/runner/work/_temp/_github_workflow/.venv
+
+      - name: Get Python version from .python-version file
+        id: get-python-version
+        run: echo "python-version=$(cut -d '.' -f 1,2 .python-version)" >> "$GITHUB_OUTPUT"
+
+      - name: Lint Code Base
+        uses: super-linter/super-linter/slim@v6
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          DEFAULT_BRANCH: main
+          VALIDATE_ALL_CODEBASE: true
+          LINTER_RULES_PATH: .
+          PYTHONPATH: "/github/workspace:/github/workflow/.venv/lib/python${{ steps.get-python-version.outputs.python-version }}/site-packages"
+          MARKDOWN_CONFIG_FILE: .markdownlint.json
+          PYTHON_BLACK_CONFIG_FILE: pyproject.toml
+          PYTHON_ISORT_CONFIG_FILE: pyproject.toml
+          PYTHON_PYLINT_CONFIG_FILE: pyproject.toml
+          PYTHON_RUFF_CONFIG_FILE: pyproject.toml
+          VALIDATE_BASH_EXEC: false
+          VALIDATE_CHECKOV: false
+          VALIDATE_CLOUDFORMATION: false
+          VALIDATE_JSCPD: false
+          VALIDATE_SHELL_SHFMT: false
+          VALIDATE_BASH: false
+          VALIDATE_DOCKERFILE_HADOLINT: false
diff --git a/examples/fastapi-simple-docker-pip/.github/workflows/security-scan.yml b/examples/fastapi-simple-docker-pip/.github/workflows/security-scan.yml
new file mode 100644
index 0000000..be5cfe9
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/.github/workflows/security-scan.yml
@@ -0,0 +1,59 @@
+---
+name: Security Scan
+
+on:
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+  schedule:
+    - cron: '31 1,12 * * *'
+
+  push:
+    branches:
+      - main
+
+  pull_request:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  security-scan:
+    runs-on: ubuntu-22.04
+    timeout-minutes: 5
+
+    permissions:
+      security-events: write
+      actions: read
+      contents: read
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Run Trivy vulnerability scanner
+        uses: aquasecurity/trivy-action@0.24.0
+        with:
+          scan-type: config
+          hide-progress: true
+          output: trivy.txt
+
+      - name: Publish Trivy Output to Summary
+        run: |
+          if [[ -s trivy.txt ]]; then
+            {
+              echo "### Security Output"
+              echo "<details><summary>Click to expand</summary>"
+              echo ""
+              echo '```terraform'
+              cat trivy.txt
+              echo '```'
+              echo "</details>"
+            } >> "${GITHUB_STEP_SUMMARY}"
+          fi
diff --git a/examples/fastapi-simple-docker-pip/.github/workflows/todo.yml b/examples/fastapi-simple-docker-pip/.github/workflows/todo.yml
new file mode 100644
index 0000000..9cb6564
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/.github/workflows/todo.yml
@@ -0,0 +1,28 @@
+---
+name: Todo Checker
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  todo:
+    name: TODO
+
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      issues: write
+
+    steps:
+      - name: Begin CI...
+        uses: actions/checkout@v4
+
+      - name: TODO to Issue
+        uses: alstr/todo-to-issue-action@v5
+        id: todo
diff --git a/examples/fastapi-simple-docker-pip/.gitignore b/examples/fastapi-simple-docker-pip/.gitignore
new file mode 100755
index 0000000..b37c8ae
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/.gitignore
@@ -0,0 +1,152 @@
+##### IDE's #####
+# VisualStudioCode
+/.vscode/
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+*.code-workspace
+.history
+
+# IntelliJ IDEA
+.idea/*
+
+##### Database #####
+*.accdb
+*.db
+*.dbf
+*.mdb
+*.pdb
+*.sqlite3
+alembic/versions/*
+
+
+##### Logs #####
+*.log
+*.log*
+
+##### Python #####
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+bin/
+
+# Environments
+Makefile
+.env
+.env.*
+.env.local
+!.env.example
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+.flaskenv
+pyvenv.cfg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Translations
+*.mo
+*.pot
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# IPython
+profile_default/
+ipython_config.py
+
+# PEP 582
+__pypackages__/
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+
+# ruff
+.ruff_cache/
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# C extensions
+*.so
+
+##### Heroku (old) #####
+Procfile
+
+# Serverless
+node_modules/
+.serverless/
+
+# wsgi
+wsgi_handler.py
+serverless_wsgi.py
+.serverless-wsgi
+
+#OSx
+.DS_Store
+
+run.Ps1
diff --git a/examples/fastapi-simple-docker-pip/.markdownlint.json b/examples/fastapi-simple-docker-pip/.markdownlint.json
new file mode 100644
index 0000000..7c226a0
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/.markdownlint.json
@@ -0,0 +1,8 @@
+{
+  "MD041": false,
+  "MD042": false,
+  "MD004": false,
+  "MD013": false,
+  "MD033": false,
+  "MD024": false
+}
diff --git a/examples/fastapi-simple-docker-pip/.pre-commit-config.yaml b/examples/fastapi-simple-docker-pip/.pre-commit-config.yaml
new file mode 100644
index 0000000..345b0ee
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/.pre-commit-config.yaml
@@ -0,0 +1,28 @@
+---
+# See https://pre-commit.com for more information
+# See https://pre-commit.com/hooks.html for more hooks
+repos:
+  - repo: https://github.com/pycqa/flake8
+    rev: 6.0.0
+    hooks:
+      - id: flake8
+        additional_dependencies: [flake8-black, flake8-bugbear]
+        args: [--config, .flake8]
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.5.1
+    hooks:
+      - id: ruff
+        args: [--fix]
+  - repo: https://github.com/pycqa/isort
+    rev: 5.12.0
+    hooks:
+      - id: isort
+        args: [--profile, black]
+  - repo: local
+    hooks:
+      - id: pytest
+        name: pytest
+        entry: pytest
+        language: system
+        pass_filenames: false
+        always_run: true
diff --git a/examples/fastapi-simple-docker-pip/.shellcheckrc b/examples/fastapi-simple-docker-pip/.shellcheckrc
new file mode 100644
index 0000000..abc0594
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/.shellcheckrc
@@ -0,0 +1,5 @@
+disable=SC1090 # Non-constant source
+disable=SC1091 # Not specified as input
+disable=SC2034 # Unused variables (they are used but in other scripts)
+disable=SC2154 # Referenced, but not assigned
+disable=SC1071 # Unknown shell
diff --git a/examples/fastapi-simple-docker-pip/Dockerfile b/examples/fastapi-simple-docker-pip/Dockerfile
new file mode 100644
index 0000000..3d4541a
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/Dockerfile
@@ -0,0 +1,62 @@
+# Stage 1: Build development dependencies
+FROM python:3.12.0 AS builder-dev
+
+WORKDIR /code
+
+# Install system dependencies for psycopg2 and pipenv
+RUN apt-get update \
+    && apt-get install --no-install-recommends -y \
+    libpq-dev \
+    gcc=4:12.2.0-3 \
+    && pip install --no-cache-dir --upgrade pip==24.1.2 \
+    && pip install --no-cache-dir pipenv==2024.0.1
+
+# Copy Pipfiles
+COPY Pipfile Pipfile.lock ./
+
+# Install development dependencies
+RUN pipenv install --dev --system --deploy
+
+# Stage 2: Build production dependencies
+FROM python:3.12.0-alpine AS builder-prod
+
+WORKDIR /code
+
+# Install system dependencies for psycopg2 and pipenv
+RUN apk update \
+    && apk add --no-cache \
+    postgresql15-dev=15.7-r0 \
+    gcc=12.2.1_git20220924-r10 \
+    musl-dev=1.2.4-r2 \
+    && pip install --no-cache-dir --upgrade pip==24.1.4 \
+    && pip install --no-cache-dir pipenv==2024.0.1
+
+# Copy Pipfiles
+COPY Pipfile Pipfile.lock ./
+
+# Install production dependencies
+RUN PIPENV_VENV_IN_PROJECT=1 pipenv install --deploy --sytem
+
+# Stage 3: Final image
+FROM python:3.12.0-alpine as production
+
+WORKDIR /code
+
+# Install runtime dependencies for psycopg2
+RUN apk update \
+    && apk add libpq=15.7-r0
+
+# Copy production dependencies from builder-prod stage
+COPY --from=builder-prod /usr/local /usr/local
+
+# Copy the application code
+COPY ./app ./app
+
+# Create a non-root user to run the application
+RUN adduser -D -H nonroot
+
+# Switch to the non-root user
+USER nonroot
+
+# Command to run the application
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
diff --git a/examples/fastapi-simple-docker-pip/Pipfile b/examples/fastapi-simple-docker-pip/Pipfile
new file mode 100644
index 0000000..0721a36
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/Pipfile
@@ -0,0 +1,43 @@
+[[source]]
+url = "https://pypi.org/simple"
+verify_ssl = true
+name = "pypi"
+
+[packages]
+alembic = "==1.13.1"
+boto3 = "==1.34.135"
+email-validator = "==2.2.0"
+fastapi = "==0.111.0"
+geoalchemy2 = {version = "==0.15.1", extras = ["shapely"]}
+mangum = "==0.17.0"
+numpy = "==1.26.4"
+psycopg2-binary = "==2.9.9"
+pydantic = "==2.7.1"
+pydantic-core = "==2.18.2"
+pydantic-settings = "==2.2.1"
+python-jose = "*"
+shapely = "==2.0.4"
+sqlalchemy = "==2.0.30"
+uvicorn = "==0.29.0"
+
+[dev-packages]
+black = "*"
+boto3-stubs = "*"
+flake8 = "*"
+flake8-black = "*"
+flake8-bugbear = "*"
+isort = "*"
+mypy = "*"
+mypy-boto3 = "*"
+mypy-extensions = "*"
+pylint = "*"
+pytest = "*"
+pytest-asyncio = "*"
+pytest-cov = "*"
+pytest-mock = "*"
+ruff = "*"
+types-python-jose = "*"
+types-shapely = "*"
+
+[requires]
+python_version = "3.12"
diff --git a/examples/fastapi-simple-docker-pip/README.md b/examples/fastapi-simple-docker-pip/README.md
new file mode 100644
index 0000000..be2487b
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/README.md
@@ -0,0 +1,41 @@
+# Example Fast API
+
+This repository contains the source code for the note-go API. The API is built using FastAPI.
+
+## Requirements 🛠️
+
+To get started, make sure you have the following tools installed on your machine:
+
+- [Docker](https://www.docker.com/) for local development.
+- [Docker Compose](https://docs.docker.com/compose/) to manage multi-container Docker applications.
+- [pyenv](https://github.com/pyenv/pyenv) to easily switch Python versions between different projects.
+- [Pipenv](https://pipenv.pypa.io/en/latest/) to manage Python dependencies.
+
+  **Python Version:** You'll need Python 3.12 installed on your local development machine. You can use [pyenv](https://github.com/pyenv/pyenv) to easily switch Python versions between different projects. If you're on Windows, consider using [pyenv-win](https://github.com/pyenv-win/pyenv-win).
+
+## ⚡️ Quickstart
+
+**Install Python**, **Python Dependencies**, and set the **Pre-commit Hooks**
+
+```sh
+pyenv install
+pyenv local
+pipenv install --dev
+pipenv run pre-commit install
+pipenv shell
+```
+
+## Running the App 🏃‍♀️🏃‍♂️
+
+To launch the app, simply run:
+
+```sh
+cp .env.example .env.local # Then edit .env.local file with your own values
+./scripts/ctl --backend # You can run ./bin/ctl --help to see all available commands
+```
+
+Your app will be up and running in no time! 🚀🎉
+
+This will start the following services:
+
+- `web`: FastAPI server running at [http://localhost:8000](http://localhost:8000)
diff --git a/examples/fastapi-simple-docker-pip/app/__init__.py b/examples/fastapi-simple-docker-pip/app/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/examples/fastapi-simple-docker-pip/app/auth/__init__.py b/examples/fastapi-simple-docker-pip/app/auth/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/examples/fastapi-simple-docker-pip/app/auth/auth.py b/examples/fastapi-simple-docker-pip/app/auth/auth.py
new file mode 100644
index 0000000..b3a038e
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/app/auth/auth.py
@@ -0,0 +1,66 @@
+import uuid
+from typing import Annotated, Dict
+
+from fastapi import Depends, HTTPException, Query, status
+from fastapi.security import HTTPAuthorizationCredentials, HTTPBearer
+from jose import JWTError, jwt
+from jose.exceptions import ExpiredSignatureError
+
+from app.config import settings
+from app.schemas.user import User
+
+from .generic_auth_provider import AuthProvider
+from .mock_auth_provider import MockAuthProvider
+
+security_scheme = HTTPBearer()
+
+def get_auth_provider() -> AuthProvider:
+    return MockAuthProvider()
+
+async def get_access_token(
+    token: Annotated[HTTPAuthorizationCredentials, Depends(security_scheme)],
+    auth_provider: Annotated[AuthProvider, Depends(get_auth_provider)]
+) -> Dict[str, any] | HTTPException:
+    try:
+        payload = jwt.decode(
+            token.credentials, "", algorithms=["HS256"], options={"verify_signature": False}
+        )
+        sub: str | None = payload.get("sub")
+        if sub is None:
+            raise HTTPException(
+                status_code=status.HTTP_400_BAD_REQUEST, detail="Could not validate credentials"
+            )
+        uuid.UUID(sub)
+        access_token = auth_provider.authenticate_user(token.credentials)
+    except ExpiredSignatureError as e:
+        raise HTTPException(
+            status_code=status.HTTP_401_UNAUTHORIZED, detail="Token has expired"
+        ) from e
+    except (JWTError, ValueError, AssertionError) as e:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST, detail="Invalid token format"
+        ) from e
+    return access_token
+
+async def get_current_user(
+    access_token: Annotated[Dict[str, any], Depends(get_access_token)],
+    auth_provider: Annotated[AuthProvider, Depends(get_auth_provider)],
+    impersonation_sub: str | None = Query(None, description="Impersonation user sub."),
+) -> User | HTTPException:
+    user_data = auth_provider.get_user(access_token['sub'])
+    user = User(
+        id=uuid.UUID(user_data['id'], version=4),
+        sub=user_data['sub'],
+        username=user_data['username'],
+        is_premium=user_data.get('is_premium', False),
+        email=user_data.get('email', ""),
+        groups=user_data.get('groups', []),
+    )
+    if not settings.auth_provider_enabled:
+        return user
+    try:
+        # Additional logic here if needed
+        return user
+    except Exception as e:
+        raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail=str(e))
+    
\ No newline at end of file
diff --git a/examples/fastapi-simple-docker-pip/app/auth/generic_auth_provider.py b/examples/fastapi-simple-docker-pip/app/auth/generic_auth_provider.py
new file mode 100644
index 0000000..0892c0d
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/app/auth/generic_auth_provider.py
@@ -0,0 +1,27 @@
+from abc import ABC, abstractmethod
+from typing import Any, List, Dict
+
+class AuthProvider(ABC):
+    @abstractmethod
+    def authenticate_user(self, token: str) -> Dict[str, Any]:
+        pass
+
+    @abstractmethod
+    def get_user(self, user_id: str) -> Dict[str, Any]:
+        pass
+
+    @abstractmethod
+    def create_user(self, email: str, attributes: List[Dict[str, Any]], groups: List[str]) -> Dict[str, Any]:
+        pass
+
+    @abstractmethod
+    def update_user(self, email: str, attributes: List[Dict[str, Any]], groups: List[str]) -> None:
+        pass
+
+    @abstractmethod
+    def delete_user(self, email: str) -> None:
+        pass
+
+    @abstractmethod
+    def set_user_password(self, email: str, password: str, permanent: bool = True) -> None:
+        pass
diff --git a/examples/fastapi-simple-docker-pip/app/auth/mock_auth_provider.py b/examples/fastapi-simple-docker-pip/app/auth/mock_auth_provider.py
new file mode 100644
index 0000000..66e7bdd
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/app/auth/mock_auth_provider.py
@@ -0,0 +1,36 @@
+from typing import Any, List, Dict
+from .generic_auth_provider import AuthProvider
+
+class MockAuthProvider(AuthProvider):
+    def authenticate_user(self, token: str) -> Dict[str, Any]:
+        return {
+            "sub": "123e4567-e89b-12d3-a456-426614174000",
+            "username": "mockuser",
+            "is_premium": True,
+            "email": "mockuser@example.com",
+            "groups": ["user", "admin"]
+        }
+
+    def get_user(self, user_id: str) -> Dict[str, Any]:
+        return {
+            "id": "123e4567-e89b-12d3-a456-426614174000",
+            "sub": "123e4567-e89b-12d3-a456-426614174000",
+            "username": "mockuser",
+            "is_premium": True,
+            "email": "mockuser@example.com",
+            "groups": ["user", "admin"]
+        }
+
+    def create_user(self, email: str, attributes: List[Dict[str, Any]], groups: List[str]) -> Dict[str, Any]:
+        return {
+            "response": "User created successfully"
+        }
+
+    def update_user(self, email: str, attributes: List[Dict[str, Any]], groups: List[str]) -> None:
+        pass
+
+    def delete_user(self, email: str) -> None:
+        pass
+
+    def set_user_password(self, email: str, password: str, permanent: bool = True) -> None:
+        pass
diff --git a/examples/fastapi-simple-docker-pip/app/config.py b/examples/fastapi-simple-docker-pip/app/config.py
new file mode 100644
index 0000000..77caab1
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/app/config.py
@@ -0,0 +1,25 @@
+from pydantic import Field
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class AppSettings(BaseSettings):
+    title: str = Field(alias="APP_TITLE", default="note-go's API")
+    version: str = Field(alias="APP_VERSION", default="0.1.2")
+    stage: str = Field(alias="STAGE", default="local")
+
+class EmailSettings(BaseSettings):
+    model_config = SettingsConfigDict(extra="ignore")
+    smtp_host: str | None = Field(alias="EMAIL_SMTP_HOST", default=None)
+    smtp_port: int | None = Field(alias="EMAIL_SMTP_PORT", default=None)
+    smtp_user: str | None = Field(alias="EMAIL_SMTP_USER", default=None)
+    smtp_password: str | None = Field(alias="EMAIL_SMTP_PASSWORD", default=None)
+    from_email: str | None = Field(alias="EMAIL_FROM_EMAIL", default=None)
+    to_email: str | None = Field(alias="EMAIL_TO_EMAIL", default=None)
+
+
+class Settings(BaseSettings):
+    app: AppSettings = AppSettings()
+    email: EmailSettings = EmailSettings()
+
+
+settings = Settings()
diff --git a/examples/fastapi-simple-docker-pip/app/constants.py b/examples/fastapi-simple-docker-pip/app/constants.py
new file mode 100644
index 0000000..51733ca
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/app/constants.py
@@ -0,0 +1,6 @@
+from types import SimpleNamespace
+
+ASC = "asc"
+DESC = "desc"
+
+ADMIN_ROLE = "admin"
diff --git a/examples/fastapi-simple-docker-pip/app/database.py b/examples/fastapi-simple-docker-pip/app/database.py
new file mode 100644
index 0000000..12f1d5c
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/app/database.py
@@ -0,0 +1,12 @@
+from sqlalchemy import create_engine
+from sqlalchemy.orm import declarative_base, sessionmaker
+
+from .config import settings
+
+SQLALCHEMY_DATABASE_URL = settings.database.url
+
+engine = create_engine(SQLALCHEMY_DATABASE_URL)
+
+SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
+
+Base = declarative_base()
diff --git a/examples/fastapi-simple-docker-pip/app/main.py b/examples/fastapi-simple-docker-pip/app/main.py
new file mode 100644
index 0000000..4eaf2b2
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/app/main.py
@@ -0,0 +1,31 @@
+from time import time
+
+from fastapi import FastAPI, Request, Response
+from fastapi.middleware.cors import CORSMiddleware
+from mangum import Mangum
+
+from app.config import settings
+from app.router import router as api_router
+
+app = FastAPI(title=settings.app.title, version=settings.app.version)
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+
+@app.middleware("http")
+async def add_time_elapsed(request: Request, call_next) -> Response:  # type: ignore
+    start_time = time()
+    response = await call_next(request)
+    response.headers["X-Process-Time"] = str(time() - start_time)
+    return response
+
+
+app.include_router(api_router)
+
+handler = Mangum(app)
diff --git a/examples/fastapi-simple-docker-pip/app/repositories/__init__.py b/examples/fastapi-simple-docker-pip/app/repositories/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/examples/fastapi-simple-docker-pip/app/repositories/note_repository.py b/examples/fastapi-simple-docker-pip/app/repositories/note_repository.py
new file mode 100644
index 0000000..dd87112
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/app/repositories/note_repository.py
@@ -0,0 +1,50 @@
+from uuid import UUID
+
+from app.schemas.note import NoteBase
+
+
+class NoteRepository:
+    def __init__(self):
+        pass
+
+    def get_note_by_id(self, note_id: UUID) -> NoteBase:
+        mock_note = NoteBase(
+                id=str(note_id),
+                title="Mocked Note", 
+                description="This is a mocked note.", 
+                summary="summary", 
+                media_url="https://localhost", 
+                preview_image_url="https://localhost", 
+                owner_id=str(UUID("12345678-1234-5678-1234-567812345678")), 
+                created_at="2021-01-01T00:00:00", 
+                updated_at="2021-01-01T00:00:00"
+            )
+           
+        return mock_note
+
+    def get_all_notes(self) -> list[NoteBase]:
+        mock_note_list = [
+            NoteBase(
+                id=str(UUID("12345678-1234-5678-1234-567812345678")), 
+                title="Mocked Note", 
+                description="This is a mocked note.", 
+                summary="summary", 
+                media_url="https://localhost", 
+                preview_image_url="https://localhost", 
+                owner_id=str(UUID("12345678-1234-5678-1234-567812345678")), 
+                created_at="2021-01-01T00:00:00", 
+                updated_at="2021-01-01T00:00:00"
+            ),
+            NoteBase(
+                id=str(UUID("87654321-4321-8765-4321-876543218765")), 
+                title="Mocked Note", 
+                description="This is a mocked note.", 
+                summary="summary", 
+                media_url="https://localhost", 
+                preview_image_url="https://localhost", 
+                owner_id=str(UUID("12345678-1234-5678-1234-567812345678")), 
+                created_at="2021-01-01T00:00:00", 
+                updated_at="2021-01-01T00:00:00"
+            ),
+        ]
+        return [NoteBase.model_validate(note) for note in mock_note_list]
\ No newline at end of file
diff --git a/examples/fastapi-simple-docker-pip/app/router/__init__.py b/examples/fastapi-simple-docker-pip/app/router/__init__.py
new file mode 100644
index 0000000..ecb957c
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/app/router/__init__.py
@@ -0,0 +1,9 @@
+from fastapi import APIRouter
+
+from .base_routes import router as base_routes
+from .note_routes import router as note_router
+
+router = APIRouter()
+
+router.include_router(base_routes, prefix="", tags=["base"])
+router.include_router(note_router, prefix="/notes", tags=["notes"])
diff --git a/examples/fastapi-simple-docker-pip/app/router/base_routes.py b/examples/fastapi-simple-docker-pip/app/router/base_routes.py
new file mode 100644
index 0000000..f0744e2
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/app/router/base_routes.py
@@ -0,0 +1,19 @@
+from fastapi import APIRouter, Request
+
+router = APIRouter()
+
+
+@router.get("/")
+def root() -> dict[str, str]:
+    return {"message": "Hello World"}
+
+
+@router.get("/test")
+def test(request: Request) -> dict[str, str]:
+    # return request headers
+    return dict(request.headers)
+
+
+@router.get("/healthz")
+def healthcheck() -> dict[str, str]:
+    return {"status": "ok"}
diff --git a/examples/fastapi-simple-docker-pip/app/router/note_routes.py b/examples/fastapi-simple-docker-pip/app/router/note_routes.py
new file mode 100644
index 0000000..6727a51
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/app/router/note_routes.py
@@ -0,0 +1,26 @@
+from uuid import UUID
+
+from fastapi import APIRouter, HTTPException
+
+from app.repositories.note_repository import NoteRepository
+from app.schemas.note import NoteOut
+
+router = APIRouter()
+
+
+@router.get("/{note_id}", response_model=NoteOut, operation_id="get_note")
+def get_note(
+    note_id: UUID,
+) -> NoteOut:
+    repository = NoteRepository()
+    try:
+        note = repository.get_note_by_id(note_id)
+    except ValueError as e:
+        raise HTTPException(status_code=404, detail="Note not found.") from e
+    return note
+
+
+@router.get("/", response_model=list[NoteOut], operation_id="get_all_notes")
+def get_all_notes() -> list[NoteOut]:
+    repository = NoteRepository()
+    return repository.get_all_notes()
diff --git a/examples/fastapi-simple-docker-pip/app/schemas/__init__.py b/examples/fastapi-simple-docker-pip/app/schemas/__init__.py
new file mode 100644
index 0000000..4ff5bbc
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/app/schemas/__init__.py
@@ -0,0 +1,8 @@
+from .note import NoteBase, NoteCreate, NoteOut, NoteUpdate
+
+__all__ = [
+    "NoteBase",
+    "NoteCreate",
+    "NoteOut",
+    "NoteUpdate",
+]
diff --git a/examples/fastapi-simple-docker-pip/app/schemas/note.py b/examples/fastapi-simple-docker-pip/app/schemas/note.py
new file mode 100644
index 0000000..c7fff60
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/app/schemas/note.py
@@ -0,0 +1,23 @@
+from typing import Any
+
+from pydantic import BaseModel
+
+
+class NoteBase(BaseModel):
+    title: str
+    description: str
+    summary: Any
+    media_url: str
+    preview_image_url: str
+    owner_id: str
+
+
+class NoteCreate(NoteBase):
+    id: str
+
+class NoteUpdate(NoteBase):
+    id: str
+
+class NoteOut(NoteBase):
+    class Config:
+        from_attributes = True
diff --git a/examples/fastapi-simple-docker-pip/app/services/__init__.py b/examples/fastapi-simple-docker-pip/app/services/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/examples/fastapi-simple-docker-pip/app/services/email_service.py b/examples/fastapi-simple-docker-pip/app/services/email_service.py
new file mode 100644
index 0000000..26208ed
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/app/services/email_service.py
@@ -0,0 +1,64 @@
+from email.message import EmailMessage
+from smtplib import SMTP, SMTPException
+from typing import Any, Self
+
+from app.config import settings
+
+
+class EmailServiceException(Exception):
+    pass
+
+
+class EmailService:
+    def __init__(self, smtp_host: str, smtp_port: int, smtp_user: str, smtp_password: str) -> None:
+        self.smtp_host = smtp_host
+        self.smtp_port = smtp_port
+        self.smtp_user = smtp_user
+        self.smtp_password = smtp_password
+
+    @classmethod
+    def initialize(cls) -> Self | None:
+        if not (
+            settings.email.smtp_host
+            and settings.email.smtp_port
+            and settings.email.smtp_user
+            and settings.email.smtp_password
+            and settings.email.from_email
+            and settings.email.to_email
+        ):
+            return None
+        return cls(
+            smtp_host=settings.email.smtp_host,
+            smtp_port=settings.email.smtp_port,
+            smtp_user=settings.email.smtp_user,
+            smtp_password=settings.email.smtp_password,
+        )
+
+    def send_email(  # pylint: disable=too-many-arguments
+        self,
+        from_email: str,
+        to_email: str,
+        subject: str,
+        body: str,
+        attachments: list[dict[str, Any]] | None = None,
+    ) -> None:
+        message = EmailMessage()
+        message["From"] = from_email
+        message["To"] = to_email
+        message["Subject"] = subject
+        message.set_content(body)
+        if attachments:
+            for attachment in attachments:
+                message.add_attachment(
+                    attachment["content"],
+                    maintype=attachment["maintype"],
+                    subtype=attachment["subtype"],
+                    filename=attachment["filename"],
+                )
+        try:
+            with SMTP(self.smtp_host, self.smtp_port) as smtp:
+                smtp.starttls()
+                smtp.login(self.smtp_user, self.smtp_password)
+                smtp.send_message(message)
+        except SMTPException as e:
+            raise EmailServiceException(f"Error sending email: {e}") from e
diff --git a/examples/fastapi-simple-docker-pip/app/types.py b/examples/fastapi-simple-docker-pip/app/types.py
new file mode 100644
index 0000000..698efb0
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/app/types.py
@@ -0,0 +1,4 @@
+from uuid import UUID
+
+FiltersTypes = str | list[str] | int | float | bool | UUID | list[UUID]
+FiltersData = dict[str, FiltersTypes]
diff --git a/examples/fastapi-simple-docker-pip/app/utils.py b/examples/fastapi-simple-docker-pip/app/utils.py
new file mode 100644
index 0000000..624d2e2
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/app/utils.py
@@ -0,0 +1,24 @@
+from typing import Any
+
+from app.constants import DESC
+from app.schemas.sorting import Sorting
+
+
+def multisort(objects: list[Any], sorting: Sorting) -> list[Any]:
+    sort_by = sorting.sort_by or []
+    sort_order = sorting.sort_order or []
+
+    def sort_key(obj: list[Any]) -> tuple[Any]:
+        keys = []
+        for attr, order in zip(sort_by, sort_order):
+            value = getattr(obj, attr)
+            if order == DESC:
+                if isinstance(value, (int, float)):
+                    value = -value
+                elif isinstance(value, str):
+                    value = "".join(chr(255 - ord(char)) for char in value)
+            keys.append(value)
+        return tuple(keys)
+
+    objects.sort(key=sort_key)
+    return objects
diff --git a/examples/fastapi-simple-docker-pip/compose.prod.yml b/examples/fastapi-simple-docker-pip/compose.prod.yml
new file mode 100644
index 0000000..a51617e
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/compose.prod.yml
@@ -0,0 +1,11 @@
+---
+services:
+  web:
+    build:
+      context: .
+      dockerfile: Dockerfile
+      target: production
+    ports:
+      - "80:80"
+    volumes:
+      - ./app:/code/app
diff --git a/examples/fastapi-simple-docker-pip/compose.yml b/examples/fastapi-simple-docker-pip/compose.yml
new file mode 100644
index 0000000..4b7a4b4
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/compose.yml
@@ -0,0 +1,14 @@
+---
+services:
+  web:
+    build:
+      context: .
+      dockerfile: Dockerfile
+      target: builder-dev
+    ports:
+      - "8000:8000"
+    env_file:
+      - ./.env.local
+    volumes:
+      - ./app:/code/app
+    command: ["uvicorn", "app.main:app", "--reload", "--host", "0.0.0.0", "--port", "8000"]
diff --git a/examples/fastapi-simple-docker-pip/docs/.gitkeep b/examples/fastapi-simple-docker-pip/docs/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/examples/fastapi-simple-docker-pip/pyproject.toml b/examples/fastapi-simple-docker-pip/pyproject.toml
new file mode 100644
index 0000000..6681ecf
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/pyproject.toml
@@ -0,0 +1,44 @@
+[tool.black]
+line-length = 100
+
+[tool.pylint."messages_control"]
+max-line-length = 100
+disable = [
+    "missing-module-docstring",
+    "missing-class-docstring",
+    "missing-function-docstring",
+    "too-few-public-methods",
+    "duplicate-code",
+]
+ignored-modules="alembic.context"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+
+[tool.mypy]
+plugins = [
+  "pydantic.mypy",
+]
+
+follow_imports = "silent"
+warn_redundant_casts = true
+warn_unused_ignores = true
+disallow_any_generics = true
+check_untyped_defs = true
+no_implicit_reexport = true
+
+# for strict mypy: (this is the tricky one :-))
+disallow_untyped_defs = true
+
+[tool.mypy-botocore]
+ignore_missing_imports = true
+
+[tool.pydantic-mypy]
+init_forbid_extra = true
+init_typed = true
+warn_required_dynamic_aliases = true
+
+[tool.isort]
+profile = "black"
+line_length = 100
+src_paths = ["app", "test"]
diff --git a/examples/fastapi-simple-docker-pip/scripts/ctl b/examples/fastapi-simple-docker-pip/scripts/ctl
new file mode 100755
index 0000000..ec0c0b1
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/scripts/ctl
@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+
+## note-go API Development Tool
+## Copyright (2024) NaNLABS
+## Licensed under XYZ
+##
+## This script is a wrapper around docker compose to run the services locally.
+##
+##	 @script.name [option] ARGUMENTS...
+##
+## Options:
+##   -h, --help             Show this help text.
+##   -b, --backend          Run the backend service
+##       --command=COMMAND  Command to run. Allow to pass through parameters directly to docker compose
+##
+
+set -e
+
+ROOT="$(realpath "$(dirname "$0")"/..)"
+source "${ROOT}/scripts/easy-options/easyoptions.sh" || exit 1
+
+# Run from the root to save docker context
+cd "${ROOT}" || exit 1
+
+# Check if docker is available
+if ! command -v docker &>/dev/null; then
+	echo "Docker is not available. Please install docker to run the services locally."
+	exit 1
+fi
+
+COMPOSE_COMMAND="docker compose"
+
+# Check if compose is available in docker
+if ! docker compose version &>/dev/null; then
+	echo "Docker compose is not available. Falling back to docker-compose."
+	COMPOSE_COMMAND="docker-compose"
+	if ! command -v docker-compose &>/dev/null; then
+		echo "Docker-compose is not available. Please install docker-compose or upgrade docker to use docker compose."
+		exit 1
+	fi
+fi
+
+command="${command:-up}"
+
+COMPOSE="${COMPOSE_COMMAND}"
+if [[ -n "$backend" ]]; then
+	COMPOSE="${COMPOSE} --file ${ROOT}/compose.yml"
+fi
+
+echo "Running command: ${COMPOSE} ${command} ${arguments[*]}"
+${COMPOSE} "${command}" "${arguments[@]}"
+
diff --git a/examples/fastapi-simple-docker-pip/scripts/easy-options/easyoptions.sh b/examples/fastapi-simple-docker-pip/scripts/easy-options/easyoptions.sh
new file mode 100644
index 0000000..772c0a6
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/scripts/easy-options/easyoptions.sh
@@ -0,0 +1,212 @@
+#!/bin/bash
+
+##
+##     EasyOptions 2015.2.28
+##     Copyright (c) 2013, 2014 Renato Silva
+##     BSD licensed
+##
+## This script is supposed to parse command line arguments in a way that,
+## even though its implementation is not trivial, it should be easy and
+## smooth to use. For using this script, simply document your target script
+## using double-hash comments, like this:
+##
+##     ## Program Name v1.0
+##     ## Copyright (C) Someone
+##     ##
+##     ## This program does something. Usage:
+##     ##     @#script.name [option]
+##     ##
+##     ## Options:
+##     ##     -h, --help              All client scripts have this by default,
+##     ##                             it shows this double-hash documentation.
+##     ##
+##     ##     -o, --option            This option will get stored as option=yes.
+##     ##                             Long version is mandatory, and can be
+##     ##                             specified before or after short version.
+##     ##
+##     ##         --some-boolean      This will get stored as some_boolean=yes.
+##     ##
+##     ##         --some-value=VALUE  This will get stored as some_value=VALUE,
+##     ##                             where VALUE is the actual value specified.
+##     ##                             The equal sign is optional and can be
+##     ##                             replaced with blank space. Short version
+##     ##                             is not available in this format.
+##
+## The above comments work both as source code documentation and as help
+## text, as well as define the options supported by your script. Parsing
+## of the options from such documentation is quite slow, but at least there
+## is not any duplication of the options specification. The string @#script.name
+## will be replaced with the actual script name.
+##
+## After writing your documentation, you simply source this script. Then all
+## command line options will get parsed into the corresponding variables,
+## as described above. You can then check their values for reacting to them.
+## Regular arguments will be available in the $arguments array.
+##
+## In fact, this script is an example of itself. You are seeing this help
+## message either because you are reading the source code, or you have called
+## the script in command line with the --help option.
+##
+## For better speed, you may want to define the options in source code yourself,
+## so they do not need to be parsed from the documentation. The side effect is
+## that when changing them, you will need to update both the documentation and
+## the source code. You define the options statically like this:
+##
+##     options=(o=option some-boolean some-value=?)
+##
+
+show_error() {
+    echo "Error: $1." >&2
+    echo "See --help for usage and options." >&2
+}
+
+parse_documentation() {
+    documentation="$(grep "^##" "$(which "$0")")(no-trim)"
+    documentation=$(echo "$documentation" | sed -r "s/## ?//" | sed -r "s/@script.name/$(basename "$0")/g" | sed "s/@#/@/g")
+    documentation=${documentation%(no-trim)}
+}
+
+parse_options() {
+
+    local short_option_vars
+    local short_options
+    local documentation
+    local next_is_value
+    local argument
+
+    local option
+    local option_name
+    local option_value
+    local option_var
+
+    local known_option
+    local known_option_name
+    local known_option_var
+
+    # Parse known options from documentation
+    if [[ -z ${options+defined} ]]; then
+        parse_documentation
+        while read -r line; do
+            case "$line" in
+                "-h, --help"*)  continue ;;
+                "--help, -h"*)  continue ;;
+                -*," "--*)      option=$(echo "$line" | awk -F'(^-|, --| )'  '{ print $2"="$3 }') ;;
+                --*," "-*)      option=$(echo "$line" | awk -F'(--|, -| )'   '{ print $3"="$2 }') ;;
+                --*=*)          option=$(echo "$line" | awk -F'(--|=| )'     '{ print $2"=?" }') ;;
+                --*" "*)        option=$(echo "$line" | awk -F'(--| )'       '{ print $2 }') ;;
+                *)              continue ;;
+            esac
+            options+=("$option")
+        done <<< "$documentation"
+    fi
+
+    options+=(h=help)
+    arguments=()
+
+    # Prepare known options
+    for option in "${options[@]}"; do
+        option_var=${option#*=}
+        option_name=${option%=$option_var}
+        if [[ "${#option_name}" = "1" ]]; then
+            short_options="${short_options}${option_name}"
+            if [[ "${#option_var}" > "1" ]]; then
+                short_option_vars+=("$option_var")
+            fi
+        fi
+    done
+
+    # Extract regular arguments
+    index=1
+    parameters=()
+    for argument in "$@"; do
+        if [[ "$argument" = -* ]]; then
+            parameters+=("$argument")
+            for known_option in "${options[@]}"; do
+                known_option_var=${known_option#*=}
+                known_option_name=${known_option%=$known_option_var}
+                if [[ "$known_option_var" = "?" && "$argument" = --$known_option_name ]]; then
+                    next_is_value="yes"
+                    break
+                fi
+            done
+        else
+            if [[ -z "$next_is_value" ]]; then
+                arguments+=("${!index}")
+            else
+                parameters+=("$argument")
+            fi
+            next_is_value=""
+        fi
+        index=$((index + 1))
+    done
+    set -- "${parameters[@]}"
+
+    # Parse the provided options
+    while getopts ":${short_options}-:" option; do
+        option="${option}${OPTARG}"
+        option_value=""
+
+        # Set the corresponding variable for known options
+        for known_option in "${options[@]}" "${short_option_vars[@]}"; do
+            known_option_var=${known_option#*=}
+            known_option_name=${known_option%=$known_option_var}
+
+            # Short option
+            if [[ "$option" = "$known_option_name" ]]; then
+                option_value="yes"
+                known_option_var=$(echo "$known_option_var" | tr "-" "_")
+                eval "$known_option_var=\"$option_value\""
+                break
+
+            # Long option
+            elif [[ "$option" = -$known_option_name && "$known_option_var" != "?" ]]; then
+                option_value="yes"
+                known_option_var=$(echo "$known_option_var" | tr "-" "_")
+                eval "$known_option_var=\"$option_value\""
+                break
+
+            # Long option with value in next parameter
+            elif [[ "$option" = -$known_option_name && "$known_option_var" = "?" ]]; then
+                eval option_value="\$$OPTIND"
+                if [[ -z "$option_value" || "$option_value" = -* ]]; then
+                    show_error "you must specify a value for --$known_option_name"
+                    exit 1
+                fi
+                OPTIND=$((OPTIND + 1))
+                known_option_var=$(echo "$known_option_name" | tr "-" "_")
+                eval "$known_option_var=\"$option_value\""
+                break
+
+            # Long option with value after equal sign
+            elif [[ "$option" = -$known_option_name=* && "$known_option_var" = "?" ]]; then
+                option_value=${option#*=}
+                known_option_var=$(echo "$known_option_name" | tr "-" "_")
+                eval "$known_option_var=\"$option_value\""
+                break
+
+            # Long option with unnecessary value
+            elif [[ "$option" = -$known_option_name=* && "$known_option_var" != "?" ]]; then
+                option_value=${option#*=}
+                show_error "--$known_option_name does not accept a value, you specified \"$option_value\""
+                exit 1
+            fi
+        done
+
+        # Unknown option
+        if [[ -z "$option_value" ]]; then
+            option=${option%%=*}
+            [[ "$option" = \?* ]] && option=${option#*\?}
+            show_error "unrecognized option -$option"
+            exit 1
+        fi
+
+        # Help option
+        if [[ -n "$help" ]]; then
+            [[ -z "$documentation" ]] && parse_documentation
+            echo "$documentation"
+            exit
+        fi
+    done
+}
+
+parse_options "$@"
diff --git a/examples/fastapi-simple-docker-pip/scripts/easy-options/example.sh b/examples/fastapi-simple-docker-pip/scripts/easy-options/example.sh
new file mode 100644
index 0000000..336adf9
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/scripts/easy-options/example.sh
@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+
+## EasyOptions Example
+## Copyright (C) Someone
+## Licensed under XYZ
+##
+## This program is an example of EasyOptions. It just prints the options and
+## arguments provided in command line. Usage:
+##
+##     @script.name [option] ARGUMENTS...
+##
+## Options:
+##     -h, --help              All client scripts have this, it can be omitted.
+##     -o, --some-option       This is a boolean option. Long version is
+##                             mandatory, and can be specified before or
+##                             after short version.
+##         --some-boolean      This is a boolean option without a short version.
+##         --some-value=VALUE  This is a parameter option. When calling your script
+##                             the equal sign is optional and blank space can be
+##                             used instead. Short version is not available in this
+##                             format.
+
+ROOT="$(realpath "$(dirname "$0")")"
+. "${ROOT}/opts.sh" || exit # Bash implementation, slower
+
+# Boolean and parameter options
+[[ -n "$some_option"  ]] && echo "Option specified: --some-option"
+[[ -n "$some_boolean" ]] && echo "Option specified: --some-boolean"
+[[ -n "$some_value"   ]] && echo "Option specified: --some-value is $some_value"
+
+# Arguments
+for argument in "${arguments[@]}"; do
+    echo "Argument specified: $argument"
+done
diff --git a/examples/fastapi-simple-docker-pip/tests/__init__.py b/examples/fastapi-simple-docker-pip/tests/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/examples/fastapi-simple-docker-pip/tests/integration/__init__.py b/examples/fastapi-simple-docker-pip/tests/integration/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/examples/fastapi-simple-docker-pip/tests/integration/test_main_routes.py b/examples/fastapi-simple-docker-pip/tests/integration/test_main_routes.py
new file mode 100644
index 0000000..43c5d6d
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/tests/integration/test_main_routes.py
@@ -0,0 +1,26 @@
+import pytest
+from fastapi import status
+from httpx import AsyncClient
+
+from app.main import app
+
+
+@pytest.fixture
+async def client():
+    async with AsyncClient(app=app, base_url="http://test") as ac:
+        yield ac
+
+
+@pytest.mark.asyncio
+async def test_root_endpoint(client):  # pylint: disable=redefined-outer-name
+    response = await client.get("/")
+    assert response.status_code == status.HTTP_200_OK
+    assert response.json() == {"message": "Hello World"}
+
+
+@pytest.mark.asyncio
+async def test_healthcheck_endpoint(client):  # pylint: disable=redefined-outer-name
+    response = await client.get("/healthz")
+    assert response.status_code == status.HTTP_200_OK
+    assert response.json() == {"status": "ok"}
+
diff --git a/examples/fastapi-simple-docker-pip/tests/unit/__init__.py b/examples/fastapi-simple-docker-pip/tests/unit/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/examples/fastapi-simple-docker-pip/tests/unit/test_build.py b/examples/fastapi-simple-docker-pip/tests/unit/test_build.py
new file mode 100644
index 0000000..febf0bf
--- /dev/null
+++ b/examples/fastapi-simple-docker-pip/tests/unit/test_build.py
@@ -0,0 +1,11 @@
+from fastapi.testclient import TestClient
+
+from app.main import app
+
+client = TestClient(app)
+
+
+def test_healthcheck():
+    response = client.get("/healthz")
+    assert response.status_code == 200
+    assert response.json() == {"status": "ok"}