Add Hugging Face Spaces deployment support

Co-authored-by: Cursor <cursoragent@cursor.com>

.dockerignore

@@ -36,5 +36,17 @@ optiq.db
 # Environment secrets
 .env
 
-# Misc
+# Built frontend (rebuilt in Docker Stage 1)
+frontend/dist/
+
+# Nginx (separate deployment config, not needed in main image)
+nginx/
+
+# Cursor IDE
+.cursor/
+
+# Research documents
 EcoHackathon/
+
+# Scripts (not needed at runtime)
+scripts/

Dockerfile

@@ -0,0 +1,49 @@
+# ──────────────────────────────────────────────────
+# OptiQ — Full-stack Docker image for Hugging Face Spaces
+# Multi-stage: Node (frontend build) → Python (backend)
+# ──────────────────────────────────────────────────
+
+# ── Stage 1: Build the React frontend ────────────
+FROM node:20-alpine AS frontend
+WORKDIR /app/frontend
+COPY frontend/package*.json ./
+RUN npm ci --no-audit --no-fund
+COPY frontend/ .
+RUN npm run build
+
+# ── Stage 2: Python backend + built frontend ─────
+FROM python:3.12-slim
+WORKDIR /app
+
+# System dependencies needed by some Python packages (pandapower, scipy, etc.)
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends gcc g++ && \
+    rm -rf /var/lib/apt/lists/*
+
+# Install PyTorch CPU first (not in requirements.txt — installed via conda locally)
+RUN pip install --no-cache-dir torch --index-url https://download.pytorch.org/whl/cpu
+
+# Install remaining Python dependencies
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy application source
+COPY api/ api/
+COPY src/ src/
+COPY config.py .
+
+# Copy pre-trained model checkpoint if it exists (models/ may only contain .gitkeep)
+COPY models/ models/
+
+# Copy built frontend from Stage 1
+COPY --from=frontend /app/frontend/dist frontend/dist/
+
+# Create writable directory for SQLite database
+RUN mkdir -p /app/data
+
+# HF Spaces requires port 7860
+ENV PORT=7860
+EXPOSE 7860
+
+# Run the application
+CMD ["python", "-m", "uvicorn", "api.main:app", "--host", "0.0.0.0", "--port", "7860"]

README.md

@@ -1,3 +1,12 @@
+---
+title: OptiQ
+emoji: ⚡
+colorFrom: blue
+colorTo: green
+sdk: docker
+pinned: false
+---
+
 <p align="center">
   <img src="https://img.shields.io/badge/Python-3.12-blue?style=flat-square&logo=python" />
   <img src="https://img.shields.io/badge/Qiskit-2.3-6929C4?style=flat-square&logo=ibm" />

config.py

@@ -5,6 +5,7 @@ emission factors, and API settings.
 """
 from dataclasses import dataclass, field
 from typing import Literal
+import os
 
 
 # ---------------------------------------------------------------------------
@@ -121,8 +122,8 @@ class EgyptConfig:
 class APIConfig:
     """FastAPI server settings."""
     host: str = "0.0.0.0"
-    port: int = 8000
-    reload: bool = True
+    port: int = int(os.environ.get("PORT", "8000"))
+    reload: bool = os.environ.get("OPTIQ_RELOAD", "false").lower() == "true"
     cors_origins: list[str] = field(default_factory=lambda: ["*"])