diff --git a/.dockerignore b/.dockerignore
new file mode 100644
index 0000000..b71a71b
--- /dev/null
+++ b/.dockerignore
@@ -0,0 +1,9 @@
+.git/
+.venv/
+__pycache__/
+.pytest_cache/
+.mypy_cache/
+docs/
+.github/
+README.md
+.pre-commit-config.yaml
diff --git a/.github/workflows/ci-cd.yml b/.github/workflows/ci-cd.yml
new file mode 100644
index 0000000..ed0b5ff
--- /dev/null
+++ b/.github/workflows/ci-cd.yml
@@ -0,0 +1,120 @@
+name: CI/CD
+
+on:
+  push:
+    branches:
+      - main
+      - develop
+    tags:
+      - 'v*.*.*'
+  pull_request:
+    branches:
+      - main
+      - develop
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493
+      - uses: actions/setup-python@cfd55ca82492758d853442341ad4d8010466803a
+        with:
+          python-version: '3.12'
+      - name: Run pre-commit
+        uses: pre-commit/action@2c7b3805fd2a0fd8c1884dcaebf91fc102a13ecd
+
+  test:
+    needs: lint
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@cfd55ca82492758d853442341ad4d8010466803a
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Cache dependencies
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830
+        with:
+          path: ~/.cache/pip
+          key: v1-${{ runner.os }}-python-${{ matrix.python-version }}-${{ hashFiles('**/pyproject.toml') }}
+          restore-keys: |
+            v1-${{ runner.os }}-python-${{ matrix.python-version }}-
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+        shell: bash
+
+      - name: Run tests
+        run: pytest
+        shell: bash
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@5a1091511ad55cbe89839c7260b706298ca349f7
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          slug: ${{ github.repository }}
+          fail_ci_if_error: true
+          verbose: true
+
+  build-docs:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493
+      - name: Set up Python
+        uses: actions/setup-python@cfd55ca82492758d853442341ad4d8010466803a
+        with:
+          python-version: '3.12'
+
+      - name: Cache dependencies
+        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830
+        with:
+          path: ~/.cache/pip
+          key: v1-${{ runner.os }}-python-3.12-${{ hashFiles('**/pyproject.toml') }}
+          restore-keys: |
+            v1-${{ runner.os }}-python-3.12-
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+        shell: bash
+
+      - name: Build documentation
+        run: mkdocs build --strict
+        shell: bash
+
+  release:
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: build-docs
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493
+      - name: Set up Python
+        uses: actions/setup-python@cfd55ca82492758d853442341ad4d8010466803a
+        with:
+          python-version: '3.12'
+
+      - name: Install dependencies
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@2f6f737ca5f74c637829c0f5c3acd0e29ea5e8bf
+        with:
+          user: __token__
+          password: ${{ secrets.PYPI_API_TOKEN }}
diff --git a/.github/workflows/docker.yml b/.github/workflows/docker.yml
new file mode 100644
index 0000000..34a7090
--- /dev/null
+++ b/.github/workflows/docker.yml
@@ -0,0 +1,58 @@
+name: Docker
+
+on:
+  push:
+    branches:
+      - main
+      - develop
+
+permissions:
+  contents: read
+  packages: write
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build-scan-push:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493
+
+      - name: Log in to the Container registry
+        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@29109295f81e9208d7d86ff1c6c12d2833863392
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@e468171a9de216ec08956ac3ada2f0791b6bd435
+
+      - name: Lowercase repository name
+        id: repo_name
+        run: echo "name=$(echo ${{ github.repository }} | tr '[:upper:]' '[:lower:]')" >> $GITHUB_OUTPUT
+
+      - name: Build and push
+        uses: docker/build-push-action@263435318d21b8e681c14492fe198d362a7d2c83
+        with:
+          context: .
+          push: true
+          tags: ghcr.io/${{ steps.repo_name.outputs.name }}:${{ github.sha }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+      - name: Scan for vulnerabilities
+        uses: aquasecurity/trivy-action@b6643a29fecd7f34b3597bc6acb0a98b03d33ff8
+        with:
+          image-ref: 'ghcr.io/${{ steps.repo_name.outputs.name }}:${{ github.sha }}'
+          format: 'table'
+          exit-code: '1'
+          ignore-unfixed: true
+          vuln-type: 'os,library'
+          severity: 'CRITICAL,HIGH'
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
new file mode 100644
index 0000000..c1c054f
--- /dev/null
+++ b/.github/workflows/publish.yml
@@ -0,0 +1,43 @@
+# .github/workflows/publish.yml
+name: Publish Python Package to PyPI
+
+on:
+  # Trigger the workflow only when a new release is published
+  release:
+    types: [published]
+
+jobs:
+  pypi-publish:
+    name: Upload release to PyPI
+    runs-on: ubuntu-latest
+
+    # Define the environment for trusted publishing
+    # This name 'pypi' MUST match what you configure on PyPI
+    environment: pypi
+
+    # Grant OIDC token permission for the job
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        # No 'user' or 'password' fields are needed here.
+        # The action automatically uses the OIDC token from the
+        # 'id-token: write' permission.
diff --git a/.gitignore b/.gitignore
index b7faf40..3dd2b6c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,6 +1,6 @@
 # Byte-compiled / optimized / DLL files
 __pycache__/
-*.py[codz]
+*.py[cod]
 *$py.class
 
 # C extensions
@@ -20,7 +20,6 @@ parts/
 sdist/
 var/
 wheels/
-share/python-wheels/
 *.egg-info/
 .installed.cfg
 *.egg
@@ -46,10 +45,9 @@ htmlcov/
 nosetests.xml
 coverage.xml
 *.cover
-*.py.cover
+*.py,cover
 .hypothesis/
 .pytest_cache/
-cover/
 
 # Translations
 *.mo
@@ -72,7 +70,6 @@ instance/
 docs/_build/
 
 # PyBuilder
-.pybuilder/
 target/
 
 # Jupyter Notebook
@@ -83,48 +80,28 @@ profile_default/
 ipython_config.py
 
 # pyenv
-#   For a library or package, you might want to ignore these files since the code is
-#   intended to run in multiple environments; otherwise, check them in:
-# .python-version
+.python-version
 
 # pipenv
 #   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
 #   However, in case of collaboration, if having platform-specific dependencies or dependencies
-#   having no cross-platform support, pipenv may install dependencies that don't work, or not
-#   install all needed dependencies.
+#   from different sources is not a concern, Pipfile.lock also may be ignored.
 #Pipfile.lock
 
-# UV
-#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
-#   This is especially recommended for binary packages to ensure reproducibility, and is more
-#   commonly ignored for libraries.
-#uv.lock
-
 # poetry
 #   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
-#   This is especially recommended for binary packages to ensure reproducibility, and is more
-#   commonly ignored for libraries.
-#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#   This is especially true if you want to ensure deterministic builds.
+#   However, in some cases, it may be desirable to ignore them.
 #poetry.lock
-#poetry.toml
 
 # pdm
 #   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
-#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
-#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
 #pdm.lock
-#pdm.toml
-.pdm-python
-.pdm-build/
-
-# pixi
-#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
-#pixi.lock
-#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
-#   in the .venv directory. It is recommended not to include this directory in version control.
-.pixi
-
-# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+#   pdm stores its cache in the specified location, which is ~/.pdm/cache by default.
+#   It might be desirable to ignore it if you use a different cache directory.
+#.pdm-cache/
+
+# PEP 582; used by pdm
 __pypackages__/
 
 # Celery stuff
@@ -136,7 +113,6 @@ celerybeat.pid
 
 # Environments
 .env
-.envrc
 .venv
 env/
 venv/
@@ -152,7 +128,7 @@ venv.bak/
 .ropeproject
 
 # mkdocs documentation
-/site
+site/
 
 # mypy
 .mypy_cache/
@@ -167,41 +143,3 @@ dmypy.json
 
 # Cython debug symbols
 cython_debug/
-
-# PyCharm
-#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
-#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
-#  and can be added to the global gitignore or merged into this file.  For a more nuclear
-#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
-#.idea/
-
-# Abstra
-# Abstra is an AI-powered process automation framework.
-# Ignore directories containing user credentials, local state, and settings.
-# Learn more at https://abstra.io/docs
-.abstra/
-
-# Visual Studio Code
-#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
-#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
-#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
-#  you could uncomment the following to ignore the entire vscode folder
-# .vscode/
-
-# Ruff stuff:
-.ruff_cache/
-
-# PyPI configuration file
-.pypirc
-
-# Cursor
-#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
-#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
-#  refer to https://docs.cursor.com/context/ignore-files
-.cursorignore
-.cursorindexingignore
-
-# Marimo
-marimo/_static/
-marimo/_lsp/
-__marimo__/
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
new file mode 100644
index 0000000..926fe08
--- /dev/null
+++ b/.pre-commit-config.yaml
@@ -0,0 +1,23 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-json
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.2
+    hooks:
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+      - id: ruff-format
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.18.2
+    hooks:
+      - id: mypy
+  - repo: https://github.com/AleksaC/hadolint-py
+    rev: v2.14.0
+    hooks:
+      - id: hadolint
diff --git a/AUDIT.md b/AUDIT.md
new file mode 100644
index 0000000..04ead6d
--- /dev/null
+++ b/AUDIT.md
@@ -0,0 +1,47 @@
+# Python Packaging Audit Report
+
+This document outlines the results of an audit of the repository against modern Python packaging standards (PEP 517, PEP 518, PEP 621, PEP 508, and PEP 660).
+
+## Phase 1: Assessment Checklist (Audit)
+
+### 1. Central Configuration and Legacy Files
+- **`pyproject.toml`**: **[PASS]** A `pyproject.toml` file exists at the root, which is mandatory for modern packaging.
+- **Legacy Files**: **[PASS]** `setup.py`, `setup.cfg`, and `requirements.txt` are not used for core metadata or dependency management. All configuration is correctly centralized in `pyproject.toml`.
+- **`poetry.lock`**: **[FAIL]** A `poetry.lock` file is present. This is a legacy artifact from a previous Poetry-based setup and is inconsistent with the current `setuptools` build backend. It must be removed.
+- **`MANIFEST.in`**: **[PASS]** This file is not present.
+
+### 2. Build System (PEP 517 & PEP 518)
+- **`[build-system]` Table**: **[PASS]** This table is present in `pyproject.toml`.
+- **`build-backend`**: **[PASS]** A modern, PEP 517-compliant backend, `setuptools.build_meta`, is specified.
+- **`requires`**: **[PASS]** The build dependencies are correctly listed as `["setuptools>=61.0"]`.
+
+### 3. Project Metadata (PEP 621)
+- **`[project]` Table**: **[PASS]** This table is present in `pyproject.toml`.
+- **Core Metadata**: **[PASS]** All required fields (`name`, `version`, `authors`, `description`, `readme`, `requires-python`, `license`) are present and statically defined.
+- **`readme`**: **[PASS]** The `readme` field correctly points to `README.md`.
+- **Classifiers**: **[PASS]** Appropriate Trove classifiers are included.
+- **`[project.urls]`**: **[PASS]** Relevant URLs are included.
+- **Entry Points**: **[PASS]** No entry points are defined, which is appropriate for this project.
+
+### 4. Dependencies (PEP 508)
+- **`dependencies`**: **[PASS]** Runtime dependencies are correctly specified as an empty array.
+- **`optional-dependencies`**: **[PASS]** Extras for development are correctly defined in `[project.optional-dependencies]`.
+
+### 5. Project Structure and Layout
+- **Layout**: **[PASS]** The project uses the recommended `src` layout (`src/my_python_project/`).
+- **`__init__.py`**: **[PASS]** The `__init__.py` file is correctly used to define a regular package.
+
+### 6. Testing Configuration
+- **Location**: **[PASS]** The test suite is located in a top-level `tests/` directory.
+- **Framework**: **[PASS]** `pytest` is used as the testing framework.
+- **Configuration**: **[PASS]** The testing configuration is centralized in `[tool.pytest.ini_options]` within `pyproject.toml`.
+
+## Conclusion
+The project is already in excellent condition and fully compliant with modern Python packaging standards. The only required action is the removal of the legacy `poetry.lock` file. No further refactoring is necessary.
+
+## Phase 3: Conformance Verification
+
+- **[X] Standards Compliance and Configuration**: `pyproject.toml` is the primary source of truth, the `[build-system]` is correctly configured, and all legacy configuration files have been removed.
+- **[X] Structure and Discoverability**: The project utilizes the `src` layout, and the build backend is correctly configured to discover packages.
+- **[X] Build Integrity**: The package builds successfully into both sdist and wheel formats using `python3 -m build`. The generated artifacts correctly include the source code, `LICENSE`, and `README` files.
+- **[X] Installation and Testing**: The package can be installed in a fresh virtual environment and in editable mode. The test suite runs successfully against the installed package.
diff --git a/CI_CD_STRATEGY.md b/CI_CD_STRATEGY.md
new file mode 100644
index 0000000..55e5e4b
--- /dev/null
+++ b/CI_CD_STRATEGY.md
@@ -0,0 +1,27 @@
+# CI/CD Strategy
+
+This document outlines the CI/CD architecture for this project, including the Docker strategy and security measures.
+
+## CI/CD Architecture
+
+The CI/CD pipeline is built using GitHub Actions and is divided into two workflows: `ci.yml` and `docker.yml`.
+
+-   **`ci.yml`**: This workflow is triggered on `push` and `pull_request` events to the `main` and `develop` branches. It consists of two jobs:
+    1.  **`lint`**: This job runs the `pre-commit` suite to ensure all code adheres to the defined quality and style standards.
+    2.  **`test`**: This job runs the `pytest` suite across a matrix of Python versions (3.10, 3.11, and 3.12) to ensure the code is working as expected. It depends on the `lint` job, so it will only run if the linting passes.
+
+-   **`docker.yml`**: This workflow is triggered on `push` events to the `main` and `develop` branches. It builds, scans, and pushes a Docker image to the GitHub Container Registry.
+
+## Docker Strategy
+
+The `Dockerfile` is a multi-stage build to create a lean and secure production image.
+
+-   **Stage 1 (Builder)**: This stage installs Poetry, exports the project dependencies to a `requirements.txt` file, and installs them. It also installs the application itself.
+-   **Stage 2 (Runtime)**: This stage uses a slim Python base image, creates a non-root user, and copies the installed dependencies and application from the builder stage. This results in a smaller and more secure final image.
+
+## Security Measures
+
+-   **Principle of Least Privilege (PoLP)**: The GitHub Actions workflows are configured with the minimum required permissions.
+-   **SHA Pinning**: All third-party GitHub Actions are pinned to their full commit SHA to prevent supply chain attacks.
+-   **Vulnerability Scanning**: The `docker.yml` workflow includes a step to scan the Docker image for vulnerabilities using Trivy. The workflow will fail if any `CRITICAL` or `HIGH` severity vulnerabilities are found.
+-   **Non-Root User**: The `Dockerfile` creates and runs the application as a non-root user to reduce the attack surface.
diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..06e7471
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,35 @@
+# Stage 1: Builder
+FROM python:3.12-slim AS builder
+
+# Install build dependencies
+RUN pip install --no-cache-dir build==1.3.0
+
+# Set the working directory
+WORKDIR /app
+
+# Copy the project files
+COPY pyproject.toml .
+COPY src/ ./src/
+
+# Build the wheel
+RUN python -m build --wheel --outdir /wheels
+
+
+# Stage 2: Runtime
+FROM python:3.12-slim AS runtime
+
+# Create a non-root user
+RUN useradd --create-home --shell /bin/bash appuser
+USER appuser
+
+# Add user's local bin to PATH
+ENV PATH="/home/appuser/.local/bin:${PATH}"
+
+# Set the working directory
+WORKDIR /home/appuser/app
+
+# Copy the wheel from the builder stage
+COPY --from=builder /wheels /wheels
+
+# Install the application wheel
+RUN pip install --no-cache-dir /wheels/*.whl
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..6a40bbe
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,57 @@
+# The Prosperity Public License 3.0.0
+
+Contributor: CoReason, Inc.
+
+Source Code: https://github.com/example/example
+
+## Purpose
+
+This license allows you to use and share this software for noncommercial purposes for free and to try this software for commercial purposes for thirty days.
+
+## Agreement
+
+In order to receive this license, you have to agree to its rules.  Those rules are both obligations under that agreement and conditions to your license.  Don't do anything with this software that triggers a rule you can't or won't follow.
+
+## Notices
+
+Make sure everyone who gets a copy of any part of this software from you, with or without changes, also gets the text of this license and the contributor and source code lines above.
+
+## Commercial Trial
+
+Limit your use of this software for commercial purposes to a thirty-day trial period.  If you use this software for work, your company gets one trial period for all personnel, not one trial per person.
+
+## Contributions Back
+
+Developing feedback, changes, or additions that you contribute back to the contributor on the terms of a standardized public software license such as [the Blue Oak Model License 1.0.0](https://blueoakcouncil.org/license/1.0.0), [the Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0.html), [the MIT license](https://spdx.org/licenses/MIT.html), or [the two-clause BSD license](https://spdx.org/licenses/BSD-2-Clause.html) doesn't count as use for a commercial purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, doesn't count as use for a commercial purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution doesn't count as use for a commercial purpose regardless of the source of funding or obligations resulting from the funding.
+
+## Defense
+
+Don't make any legal claim against anyone accusing this software, with or without changes, alone or with other technology, of infringing any patent.
+
+## Copyright
+
+The contributor licenses you to do everything with this software that would otherwise infringe their copyright in it.
+
+## Patent
+
+The contributor licenses you to do everything with this software that would otherwise infringe any patents they can license or become able to license.
+
+## Reliability
+
+The contributor can't revoke this license.
+
+## Excuse
+
+You're excused for unknowingly breaking [Notices](#notices) if you take all practical steps to comply within thirty days of learning you broke the rule.
+
+## No Liability
+
+***As far as the law allows, this software comes as is, without any warranty or condition, and the contributor won't be liable to anyone for any damages related to this software or this license, under any kind of legal claim.***
diff --git a/NOTICE b/NOTICE
new file mode 100644
index 0000000..651a000
--- /dev/null
+++ b/NOTICE
@@ -0,0 +1,6 @@
+Copyright (c) 2025-2026 CoReason, Inc
+
+This software is licensed under the Prosperity Public License 3.0.0.
+The issuer of the Prosperity Public License for this software is CoReason, Inc.
+
+For a commercial version of this software, please contact us at license@coreason.ai.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e77cb41
--- /dev/null
+++ b/README.md
@@ -0,0 +1,40 @@
+# my_python_project
+
+[![PyPI Version](https://img.shields.io/pypi/v/my_python_project)](https://pypi.org/project/my_python_project/)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/[USERNAME]/[REPO_NAME]/ci-cd.yml?branch=main)](https://github.com/[USERNAME]/[REPO_NAME]/actions/workflows/ci-cd.yml)
+[![codecov](https://codecov.io/gh/[USERNAME]/[REPO_NAME]/branch/main/graph/badge.svg)](https://codecov.io/gh/[USERNAME]/[REPO_NAME])
+[![License](https://img.shields.io/badge/License-Prosperity%203.0.0-blue.svg)](LICENSE)
+[![Code style: ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Python Versions](https://img.shields.io/pypi/pyversions/my_python_project)](https://pypi.org/project/my_python_project)
+
+This is a best-in-class Python package template.
+
+## Getting Started
+
+### Prerequisites
+
+- Python 3.10+
+- Poetry
+
+### Installation
+
+1.  Clone the repository:
+    ```sh
+    git clone https://github.com/example/example.git
+    cd my_python_project
+    ```
+2.  Install dependencies:
+    ```sh
+    poetry install
+    ```
+
+### Usage
+
+-   Run the linter:
+    ```sh
+    poetry run pre-commit run --all-files
+    ```
+-   Run the tests:
+    ```sh
+    poetry run pytest
+    ```
diff --git a/codecov.yml b/codecov.yml
new file mode 100644
index 0000000..51192f4
--- /dev/null
+++ b/codecov.yml
@@ -0,0 +1,4 @@
+comment:
+  layout: "reach,diff,flags,files,footer"
+  behavior: default
+  require_changes: false
diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 0000000..21f6d22
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,3 @@
+# Welcome to my_python_project!
+
+This is the main page of your project's documentation.
diff --git a/mkdocs.yml b/mkdocs.yml
new file mode 100644
index 0000000..de4adf5
--- /dev/null
+++ b/mkdocs.yml
@@ -0,0 +1,3 @@
+site_name: my_python_project
+theme:
+  name: material
diff --git a/pyproject.toml b/pyproject.toml
new file mode 100644
index 0000000..e3c35a0
--- /dev/null
+++ b/pyproject.toml
@@ -0,0 +1,62 @@
+[project]
+name = "my_python_project"
+version = "0.1.0"
+description = "A best-in-class Python package template."
+authors = [
+    {name = "CoReason, Inc.", email = "gowtham.rao@coreason.ai"},
+]
+readme = "README.md"
+license = "LicenseRef-Proprietary"
+license-files = ["LICENSE"]
+keywords = ["template", "poetry", "python"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+requires-python = ">=3.10"
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/[USERNAME]/[REPO_NAME]"
+Repository = "https://github.com/[USERNAME]/[REPO_NAME]"
+Documentation = "https://github.com/[USERNAME]/[REPO_NAME]"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.4.2",
+    "ruff>=0.14.2",
+    "mypy>=1.18.2",
+    "pre-commit>=4.3.0",
+    "pytest-cov>=5.0.0",
+    "mkdocs>=1.6.1",
+    "mkdocs-material>=9.6.22",
+]
+
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+addopts = "--cov=src --cov-report=xml"
+pythonpath = ["src"]
+
+[tool.ruff]
+line-length = 88
+indent-width = 4
+
+[tool.ruff.lint]
+select = ["E4", "E7", "E9", "F", "I"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "lf"
diff --git a/src/my_python_project/__init__.py b/src/my_python_project/__init__.py
new file mode 100644
index 0000000..7444a30
--- /dev/null
+++ b/src/my_python_project/__init__.py
@@ -0,0 +1,14 @@
+# Copyright (c) 2025-2026 CoReason, Inc. All Rights Reserved.
+#
+# This software is proprietary and dual-licensed.
+# Licensed under the Prosperity Public License 3.0.0 (the "License").
+# A copy of the license is available at https://prosperitylicense.com/versions/3.0.0
+# For details, see the LICENSE file.
+#
+# Commercial use beyond a 30-day trial requires a separate license.
+# Contact: gowtham.rao@coreason.ai
+
+
+def add(a: int, b: int) -> int:
+    """Adds two integers together."""
+    return a + b
diff --git a/tests/test_main.py b/tests/test_main.py
new file mode 100644
index 0000000..6e45c38
--- /dev/null
+++ b/tests/test_main.py
@@ -0,0 +1,16 @@
+# Copyright (c) 2025-2026 CoReason, Inc. All Rights Reserved.
+#
+# This software is proprietary and dual-licensed.
+# Licensed under the Prosperity Public License 3.0.0 (the "License").
+# A copy of the license is available at https://prosperitylicense.com/versions/3.0.0
+# For details, see the LICENSE file.
+#
+# Commercial use beyond a 30-day trial requires a separate license.
+# Contact: gowtham.rao@coreason.ai
+
+from my_python_project import add
+
+
+def test_add():
+    """Tests the add function."""
+    assert add(1, 2) == 3