# ClassLens v2 - Hugging Face Spaces Docker Deployment # Multi-stage build for React frontend + FastAPI backend # ============================================================================= # Stage 1: Build React Frontend # ============================================================================= FROM node:22-slim AS frontend-builder WORKDIR /app/frontend # Copy package files first for layer caching COPY chatkit/frontend/package*.json ./ # Install dependencies RUN npm ci --legacy-peer-deps # Copy source files (after npm ci to leverage cache) COPY chatkit/frontend/src ./src COPY chatkit/frontend/public ./public COPY chatkit/frontend/index.html chatkit/frontend/vite.config.ts chatkit/frontend/tsconfig*.json chatkit/frontend/postcss.config.mjs chatkit/frontend/eslint.config.mjs ./ # Build for production (output to dist/) RUN npm run build # ============================================================================= # Stage 2: Python Backend + Serve Frontend # ============================================================================= FROM python:3.11-slim # Set environment variables ENV PYTHONUNBUFFERED=1 ENV PYTHONDONTWRITEBYTECODE=1 # Create non-root user for HF Spaces RUN useradd -m -u 1000 user USER user ENV HOME=/home/user ENV PATH=/home/user/.local/bin:$PATH WORKDIR $HOME/app # Install Python dependencies COPY --chown=user chatkit/backend/pyproject.toml ./ RUN pip install --no-cache-dir --upgrade pip && \ pip install --no-cache-dir . # Copy backend code COPY --chown=user chatkit/backend/app ./app # Copy Alembic migration config (applied on startup) COPY --chown=user chatkit/backend/alembic.ini ./alembic.ini COPY --chown=user chatkit/backend/alembic ./alembic # Copy built frontend from Stage 1 COPY --from=frontend-builder --chown=user /app/frontend/dist ./static # Expose port (HF Spaces uses 7860) EXPOSE 7860 # Health check HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \ CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:7860/health')" # Apply DB migrations (Supabase) then run the server. # Migrations are a no-op for non-Postgres providers. CMD ["sh", "-c", "alembic upgrade head && uvicorn app.main:app --host 0.0.0.0 --port 7860"]