chore: migrate backend deployment from Fly.io to Hugging Face Spaces

- Dockerfile: port 8000 -> 7860 (HF Spaces requirement), use ENV PORT
- README.md: add HF Spaces YAML frontmatter, replace Fly.io deploy docs
- backend/config.py: add HF Space URL to default CORS origins
- frontend/.env.production: set VITE_WS_URL for HF Space (wss)
- frontend/.env.example: document env vars for local dev

Dockerfile

@@ -29,7 +29,9 @@ COPY CNN_Autoencoder_LightGBM/ /models/CNN_Autoencoder_LightGBM/
 COPY CNN_PreTrained/           /models/CNN_PreTrained/
 
 # ── Runtime environment ───────────────────────────────────────────────────────
+# PORT=7860 is the Hugging Face Spaces default; override with -e PORT=xxxx if needed.
 ENV WEIGHTS_DIR=/models \
+    PORT=7860 \
     KERAS_BACKEND=tensorflow \
     TF_CPP_MIN_LOG_LEVEL=3 \
     CUDA_VISIBLE_DEVICES="" \
@@ -38,11 +40,11 @@ ENV WEIGHTS_DIR=/models \
     PYTHONDONTWRITEBYTECODE=1 \
     PYTHONUNBUFFERED=1
 
-EXPOSE 8000
+EXPOSE 7860
 
 # ── Health-check ──────────────────────────────────────────────────────────────
 # Wait up to 3 minutes for models to load before marking the container healthy.
 HEALTHCHECK --interval=30s --timeout=10s --start-period=180s --retries=3 \
-    CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health', timeout=5)"
+    CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:${PORT}/health', timeout=5)"
 
-CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
+CMD uvicorn app.main:app --host 0.0.0.0 --port ${PORT}

README.md

@@ -1,3 +1,14 @@
+---
+title: SanketSetu Backend
+emoji: 🤟
+colorFrom: blue
+colorTo: purple
+sdk: docker
+app_port: 7860
+pinned: false
+short_description: Real-time Gujarati Sign Language recognition API
+---
+
 # SanketSetu
 
 A real-time sign language recognition system using machine learning and computer vision.
@@ -81,13 +92,62 @@ Run the development servers:
 .\start.ps1
 ```
 
-## Docker
+## Deployment
+
+### Backend — Hugging Face Spaces (Docker SDK)
+
+The backend is deployed as a [Hugging Face Space](https://huggingface.co/spaces) using the Docker SDK.
+
+**Steps to create a new Space and push:**
+
+1. **Create the Space** on [huggingface.co/new-space](https://huggingface.co/new-space)
+   - SDK: **Docker**
+   - Visibility: Public (or Private)
+   - Note your `username` and `space-name`
+
+2. **Clone the Space repo and push your code:**
+   ```bash
+   # Add HF Space as a remote (from repo root)
+   git remote add space https://huggingface.co/spaces/devrajsinh2012/Sanket-Setu
+
+   git push space main
+   ```
+   HF Spaces will automatically build the Docker image and start the container.
+
+3. **Set Space Secrets** (via HF Space → Settings → Repository secrets):
+   | Secret | Example value |
+   |--------|---------------|
+   | `CORS_ORIGINS` | `https://sanketsetu.vercel.app,http://localhost:5173` |
+   | `PIPELINE_MODE` | `ensemble` |
+   | `CONFIDENCE_THRESHOLD` | `0.70` |
+
+4. **Update the frontend** — set the `VITE_WS_URL` Vercel environment variable:
+   ```
+   wss://devrajsinh2012-sanket-setu.hf.space
+   ```
+   In Vercel dashboard: **Settings → Environment Variables → VITE_WS_URL**
+
+**Space URL format:**
+- HTTPS API: `https://devrajsinh2012-sanket-setu.hf.space`
+- WebSocket:  `wss://devrajsinh2012-sanket-setu.hf.space/ws/landmarks`
+- Health:     `https://devrajsinh2012-sanket-setu.hf.space/health`
+
+### Frontend — Vercel
+
+```bash
+cd frontend
+# deploy via Vercel CLI or connect the GitHub repo in Vercel dashboard
+```
+
+Set the `VITE_WS_URL` environment variable in Vercel to the HF Space WebSocket URL above.
+
+## Docker (local)
 
-Build and run using Docker:
+Build and run using Docker locally:
 
 ```bash
 docker build -t sanketsetu .
-docker run -p 8000:8000 sanketsetu
+docker run -p 7860:7860 sanketsetu
 ```
 
 ## Testing

backend/app/config.py

@@ -55,7 +55,14 @@ MAX_WS_CONNECTIONS: int = int(os.getenv("MAX_WS_CONNECTIONS", "100"))
 WS_SEND_RATE_LIMIT: int = int(os.getenv("WS_SEND_RATE_LIMIT", "15"))  # max frames/sec per client
 
 # Allowed CORS origins (comma-separated list in env var)
-_cors_env = os.getenv("CORS_ORIGINS", "http://localhost:5173,http://localhost:3000")
+# Default includes Vercel frontend and the Hugging Face Space URL.
+# Replace YOUR_HF_USERNAME and YOUR_SPACE_NAME with your actual HF values.
+_cors_env = os.getenv(
+    "CORS_ORIGINS",
+    "http://localhost:5173,http://localhost:3000,"
+    "https://sanketsetu.vercel.app,"
+    "https://devrajsinh2012-sanket-setu.hf.space",
+)
 CORS_ORIGINS: list[str] = [o.strip() for o in _cors_env.split(",") if o.strip()]
 
 # ---------------------------------------------------------------------------

frontend/.env.example

@@ -0,0 +1,9 @@
+# Frontend environment variables — copy this file to .env.local for local development
+# (Vite loads .env.local automatically; never commit .env.local)
+
+# WebSocket URL of the backend server.
+# For local development (backend running on default port):
+VITE_WS_URL=ws://localhost:8000
+
+# For production (Hugging Face Spaces backend):
+# VITE_WS_URL=wss://devrajsinh2012-sanket-setu.hf.space

frontend/.env.production

@@ -0,0 +1,7 @@
+# Production environment — used by Vercel when building the frontend.
+# Replace YOUR_HF_USERNAME and YOUR_SPACE_NAME with your actual Hugging Face values.
+# The URL format is: https://{username}-{space-name}.hf.space
+#
+# Example: if your HF username is "devrajsinh" and the Space is named "sanketsetu-backend"
+#   VITE_WS_URL=wss://devrajsinh-sanketsetu-backend.hf.space
+VITE_WS_URL=wss://devrajsinh2012-sanket-setu.hf.space