recursivezero · recursivezero · Mar 14, 2026 · Mar 10, 2026 · Mar 10, 2026 · Mar 10, 2026
@@ -1,5 +1,6 @@
 #Note specify the values within double-quotes("")
 ENVIRONMENT=development
-
+PORT=8501
+PORT_API=8502
 MONGODB_URI="mongodb://<user>:<password>@127.0.0.1:27017/?retryWrites=true&w=majority&appName=sample"
 DATABASE_NAME="sample"
@@ -53,6 +53,8 @@ poetry install

 ```bash
 poetry run sample dev
+# with custom port
+poetry run sample dev --port 8501
 ```

 Access: <http://localhost:8501>
@@ -63,6 +65,8 @@ Access: <http://localhost:8501>
 poetry run sample api
 # OR
 python src/api/fast_api.py
+# with custom port
+poetry run sample dev --port 5000
 ```

 Access: <http://127.0.0.1:5000>

@@ -1,6 +1,6 @@
 [project]
 name = "python-starterkit"
-version = "1.0.0"
+version = "1.0.1"
 description = "A python starterkit for fastapi and mongo projects."
 authors = [{ name = "admin", email = "recursivezero@outlook.com" }]
 license = "MIT"

@@ -1,13 +1,10 @@
-from sample.utils.constants import PORT
-
-
-def main():
+def main(port: int = 8501):
    """Entry point for CLI dev command."""
    from sample.api.main import start

-    print(f"🚀 Starting Sample app on port {PORT}...\n")
-    start()
+    print(f"🚀 Starting Sample app on port {port}...\n")
+    start(port)


 if __name__ == "__main__":
-    main()
+    main(port=8501)
@@ -9,7 +9,6 @@
 from sample.api.routes import greet_router
 from sample.api.web_page import web_router
 from sample.db.connection import connect_db
-from sample.utils.constants import PORT


 @asynccontextmanager
@@ -44,7 +43,7 @@ async def lifespan(app: FastAPI):
 app.include_router(greet_router)


-def start():
+def start(port: int = 5000):
    import uvicorn

-    uvicorn.run("sample.api.main:app", host="127.0.0.1", port=PORT, reload=True)
+    uvicorn.run("sample.api.main:app", host="127.0.0.1", port=port, reload=True)
@@ -1,9 +1,10 @@
 from fastapi import APIRouter, FastAPI, HTTPException, Request
 from pydantic import BaseModel
-from sample.utils.constants import API_PREFIX, GREETING, PORT
-from sample.utils.helper import normalize_name
 from starlette.responses import HTMLResponse, JSONResponse
+
 from sample import __version__
+from sample.utils.constants import API_PREFIX, GREETING
+from sample.utils.helper import normalize_name

 app = FastAPI(
    title="Sample API",
@@ -98,7 +99,7 @@ def get_help():
 app.include_router(greet_router)


-def start():
+def start(port: int = 5000):
    import uvicorn

-    uvicorn.run("sample.api.routes:app", host="127.0.0.1", port=PORT, reload=True)
+    uvicorn.run("sample.api.routes:app", host="127.0.0.1", port=port, reload=True)
@@ -1,5 +1,7 @@
 import click

+from sample.utils.constants import PORT, PORT_API
+
 from . import __version__


@@ -13,17 +15,27 @@ def cli(ctx, version):
        ctx.exit()


-@cli.command()
-def dev():
-    """Run the Sample  app."""
+@cli.command(help="Port to run the Sample app on.")
+@click.option(
+    "--port",
+    default=int(PORT),
+    show_default=True,
+    help="Port to run the Sample app on.",
+)
+def dev(port: int):
    from sample.__main__ import main

-    main()
+    main(port)


-@cli.command()
-def api():
-    """Run the Sample FastAPI backend."""
+@cli.command(help="Run the Sample FastAPI backend.")
+@click.option(
+    "--port",
+    default=int(PORT_API),
+    show_default=True,
+    help="Port to run the FastAPI backend on.",
+)
+def api(port: int):
    from sample.api.routes import start

-    start()
+    start(port)
@@ -7,6 +7,7 @@
 load_env()
 # These should be in environment variables or .env file.
 DEFAULT_PORT = 8005
+
 DEFAULT_API_PREFIX = "/api/v1"
 DEFAULT_MONGODB_URI = (
    "mongodb://127.0.0.1:27017/?retryWrites=true&w=majority&appName=Sample"
@@ -30,8 +31,10 @@ def safe_get(env_key: str, default) -> str:
    return value


+PORT = safe_get("PORT", DEFAULT_PORT)
+PORT_API = safe_get("PORT_API", int(PORT) + 1)
+
 API_PREFIX = safe_get("API_PREFIX", DEFAULT_API_PREFIX)
-PORT = int(safe_get("PORT", DEFAULT_PORT))


 def get_mongo_config():