Staging

.env.example

@@ -17,8 +17,8 @@ GOOGLE_CLIENT_SECRET=your_google_client_secret
 GITHUB_CLIENT_ID=your_github_client_id
 GITHUB_CLIENT_SECRET=your_github_client_secret
 
-# Flask configuration
-FLASK_SECRET_KEY=your_super_secret_key_here
+# FASTAPI configuration
+FASTAPI_SECRET_KEY=your_super_secret_key_here
 
 # FalkorDB configuration
 FALKORDB_HOST=localhost

.github/copilot-instructions.md

@@ -126,8 +126,8 @@ make clean
 
 ```bash
 # REQUIRED for FastAPI to start
-FLASK_SECRET_KEY=your_super_secret_key_here
-FLASK_DEBUG=False
+FASTAPI_SECRET_KEY=your_super_secret_key_here
+FASTAPI_DEBUG=False
 
 # REQUIRED for database connection (most functionality)
 FALKORDB_HOST=localhost
@@ -146,8 +146,8 @@ GITHUB_CLIENT_SECRET=your_github_client_secret
 
 **For testing in CI/development**, minimal `.env` setup:
 ```bash
-FLASK_SECRET_KEY=test-secret-key
-FLASK_DEBUG=False
+FASTAPI_SECRET_KEY=test-secret-key
+FASTAPI_DEBUG=False
 FALKORDB_HOST=localhost
 FALKORDB_PORT=6379
 ```

.github/workflows/tests.yml

@@ -42,7 +42,6 @@ jobs:
         pipenv sync --dev
 
     - name: Install frontend dependencies
-      if: "exists('app/package.json')"
       run: |
         node --version || true
         npm --version || true
@@ -51,21 +50,16 @@ jobs:
     - name: Create test environment file
       run: |
         cp .env.example .env
-        echo "FLASK_SECRET_KEY=test-secret-key" >> .env
-        echo "FLASK_DEBUG=False" >> .env
+        echo "FASTAPI_SECRET_KEY=test-secret-key" >> .env
+        echo "FASTAPI_DEBUG=False" >> .env
 
     - name: Run unit tests
       run: |
         pipenv run pytest tests/ -k "not e2e" --verbose
 
-    - name: Run pylint
+    - name: Run lint
       run: |
-        pipenv run pylint "$(git ls-files '*.py')" || true
-
-    - name: Run frontend lint
-      if: "exists('app/package.json')"
-      run: |
-        (cd app && npm run lint)
+        make lint
 
   e2e-tests:
     runs-on: ubuntu-latest
@@ -109,8 +103,8 @@ jobs:
         cp .env.example .env
         echo "FALKORDB_HOST=localhost" >> .env
         echo "FALKORDB_PORT=6379" >> .env
-        echo "FLASK_SECRET_KEY=test-secret-key-for-ci" >> .env
-        echo "FLASK_DEBUG=False" >> .env
+        echo "FASTAPI_SECRET_KEY=test-secret-key-for-ci" >> .env
+        echo "FASTAPI_DEBUG=False" >> .env
 
     - name: Wait for FalkorDB
       run: |

Dockerfile

@@ -1,4 +1,7 @@
-# Use a single stage build with FalkorDB base image
+# Multi-stage build: Start with Python 3.12 base
+FROM python:3.12-bookworm as python-base
+
+# Main stage: Use FalkorDB base and copy Python 3.12
 FROM falkordb/falkordb:latest
 
 ENV PYTHONUNBUFFERED=1 \
@@ -7,12 +10,15 @@ ENV PYTHONUNBUFFERED=1 \
 
 USER root
 
-# Install Python and pip, netcat for wait loop in start.sh
+# Copy Python 3.12 from the python base image
+COPY --from=python-base /usr/local /usr/local
+
+# Install netcat for wait loop in start.sh
 RUN apt-get update && apt-get install -y \
-    python3 \
-    python3-pip \
     netcat-openbsd \
-    && rm -rf /var/lib/apt/lists/*
+    && rm -rf /var/lib/apt/lists/* \
+    && ln -sf /usr/local/bin/python3.12 /usr/bin/python3 \
+    && ln -sf /usr/local/bin/python3.12 /usr/bin/python
 
 WORKDIR /app
 
@@ -25,6 +31,25 @@ COPY Pipfile Pipfile.lock ./
 # Install Python dependencies from Pipfile
 RUN PIP_BREAK_SYSTEM_PACKAGES=1 pipenv sync --system
 
+# Install Node.js (Node 22) so we can build the frontend inside the image.
+# Use NodeSource setup script to get a recent Node version on Debian-based images.
+RUN curl -fsSL https://deb.nodesource.com/setup_22.x | bash - \
+    && apt-get update && apt-get install -y nodejs \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy only frontend package files so Docker can cache npm installs when
+# package.json / package-lock.json don't change.
+COPY app/package*.json ./app/
+
+# Install frontend dependencies (reproducible install using package-lock)
+RUN if [ -f ./app/package-lock.json ]; then \
+            npm --prefix ./app ci --no-audit --no-fund; \
+        elif [ -f ./app/package.json ]; then \
+            npm --prefix ./app install --no-audit --no-fund; \
+        else \
+            echo "No frontend package.json found, skipping npm install"; \
+        fi
+
 # Copy application code
 COPY . .
 
@@ -34,6 +59,5 @@ RUN chmod +x /start.sh
 
 EXPOSE 5000 6379 3000
 
-
 # Use start.sh as entrypoint
 ENTRYPOINT ["/start.sh"]

Pipfile

@@ -6,7 +6,7 @@ name = "pypi"
 [packages]
 fastapi = "~=0.116.1"
 uvicorn = "~=0.32.0"
-litellm = "~=1.74.14"
+litellm = "~=1.75.9"
 falkordb = "~=1.2.0"
 psycopg2-binary = "~=2.9.9"
 pymysql = "~=1.1.0"
@@ -20,9 +20,9 @@ jinja2 = "~=3.1.4"
 [dev-packages]
 pytest = "~=8.4.1"
 pylint = "~=3.3.4"
-playwright = "~=1.47.0"
+playwright = "~=1.54.0"
 pytest-playwright = "~=0.7.0"
-pytest-asyncio = "~=0.24.0"
+pytest-asyncio = "~=1.1.0"
 
 [requires]
 python_version = "3.12"

README.md

@@ -57,7 +57,7 @@ This application supports authentication via Google and GitHub OAuth. You'll nee
 ### Running the Application
 
 ```bash
-pipenv run flask --app api.index run
+pipenv run uvicorn api.index:app --host "localhost" --port "5000"
 ```
 
 The application will be available at `http://localhost:5000`.
@@ -97,7 +97,7 @@ You can configure the application by passing environment variables using the `-e
 
 ```bash
 docker run -p 5000:5000 -it \
-  -e FLASK_SECRET_KEY=your_super_secret_key_here \
+   -e FASTAPI_SECRET_KEY=your_super_secret_key_here \
   -e GOOGLE_CLIENT_ID=your_google_client_id \
   -e GOOGLE_CLIENT_SECRET=your_google_client_secret \
   -e GITHUB_CLIENT_ID=your_github_client_id \