HF fix: uvicorn-only CMD, defensive mkdir, remove unused numpy, overlay mkdir on save, README troubleshooting

Dockerfile

@@ -31,4 +31,5 @@ USER appuser
 ENV PORT=7860
 EXPOSE 7860
 
-CMD ["sh", "-c", "gunicorn app.main:app -k uvicorn.workers.UvicornWorker --bind 0.0.0.0:${PORT} --workers 1 --timeout 120"]
+# Single process: uvicorn only (simpler for HF Spaces; avoid gunicorn restart issues)
+CMD ["sh", "-c", "exec uvicorn app.main:app --host 0.0.0.0 --port ${PORT}"]

README.md

@@ -84,3 +84,10 @@ change_detection_webapp/
 - `POST /api/detect` — form: `before`, `after` (files), `method`, `title`, etc. → returns stats, regions, overlay base64
 - `GET /api/history` — list of current user’s runs
 - `GET /api/overlay/<path>` — serve saved overlay image
+- `GET /health` — lightweight health check (no DB)
+
+## Hugging Face: Space stuck on “Restarting”
+
+1. Open your Space → **Settings** → under **Build**, click **Clear build cache** → Save. Then trigger a rebuild (push a commit or click **Restart**).
+2. Check **Logs** (Build logs + App logs) for Python errors or “Killed” (out of memory).
+3. In **Settings** → **Hardware**, try a slightly larger CPU/memory if available.

app/database.py

@@ -10,7 +10,10 @@ BASE_DIR = Path(__file__).resolve().parent
 _home_data = Path.home() / "data"
 _local_data = BASE_DIR.parent / "data"
 DATA_DIR = _home_data if os.environ.get("SPACE_ID") else _local_data
-DATA_DIR.mkdir(parents=True, exist_ok=True)
+try:
+    DATA_DIR.mkdir(parents=True, exist_ok=True)
+except Exception:
+    pass  # avoid crashing if read-only or permission issue (e.g. some HF environments)
 
 DB_PATH = DATA_DIR / "satellite_app.db"
 

app/main.py

@@ -6,7 +6,6 @@ import uuid
 from pathlib import Path
 from typing import Optional
 
-import numpy as np
 from sqlalchemy import text as sa_text
 from fastapi import FastAPI, Depends, File, Form, HTTPException, Request, UploadFile
 from fastapi.responses import FileResponse, HTMLResponse, JSONResponse
@@ -61,7 +60,10 @@ def health():
 STATIC_DIR = Path(__file__).resolve().parent.parent / "static"
 TEMPLATES_DIR = Path(__file__).resolve().parent.parent / "templates"
 OVERLAYS_DIR = DATA_DIR / "overlays"
-OVERLAYS_DIR.mkdir(parents=True, exist_ok=True)
+try:
+    OVERLAYS_DIR.mkdir(parents=True, exist_ok=True)
+except Exception:
+    pass
 THUMB_MAX_SIZE = 200  # max width or height for history thumbnails
 
 if STATIC_DIR.exists():
@@ -227,6 +229,10 @@ async def detect(
     base_name = f"{user.id}_{uuid.uuid4().hex}"
     overlay_filename = base_name + ".png"
     overlay_path = OVERLAYS_DIR / overlay_filename
+    try:
+        overlay_path.parent.mkdir(parents=True, exist_ok=True)
+    except Exception:
+        pass
     Image.fromarray(result_image).save(overlay_path)
     relative_overlay = f"overlays/{overlay_filename}"