Docker space: CreatorPulse India API

Dockerfile

@@ -0,0 +1,29 @@
+# HF Spaces (Docker SDK) — CreatorPulse India API.
+# Builds from the public GitHub repo; serves FastAPI on the HF-required port 7860.
+FROM python:3.11-slim
+
+RUN apt-get update && apt-get install -y --no-install-recommends git \
+    && rm -rf /var/lib/apt/lists/*
+
+# HF Spaces runs the container as uid 1000 — set up that user + a writable model cache.
+RUN useradd -m -u 1000 user
+USER user
+ENV HOME=/home/user \
+    PATH=/home/user/.local/bin:$PATH \
+    HF_HOME=/home/user/.cache/huggingface \
+    PYTHONUNBUFFERED=1
+
+WORKDIR /home/user/app
+
+# Pull the app + committed models/*.joblib from GitHub (single source of truth).
+RUN git clone --depth 1 https://github.com/ayushgupta07xx/creatorpulse-india.git .
+
+# Core deps (fastapi/uvicorn/sqlalchemy/psycopg2/pandas/numpy/pydantic) from the package,
+# plus only the ML libs the API actually loads at runtime. Deliberately NOT the full
+# [ml] extra — that drags prophet/mlflow/bertopic/optuna, none needed to serve.
+RUN pip install --user --no-cache-dir -e . \
+    && pip install --user --no-cache-dir \
+       "sentence-transformers>=3.0" "scikit-learn>=1.5" "xgboost>=2.0"
+
+EXPOSE 7860
+CMD ["uvicorn", "apps.api.main:app", "--host", "0.0.0.0", "--port", "7860"]

README.md

@@ -1,13 +1,27 @@
 ---
-title: Creatorpulse Api
-emoji: 👁
-colorFrom: purple
-colorTo: pink
-sdk: gradio
-sdk_version: 6.18.0
-python_version: '3.13'
-app_file: app.py
+title: CreatorPulse India API
+emoji: 📊
+colorFrom: indigo
+colorTo: green
+sdk: docker
+app_port: 7860
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# CreatorPulse India — API
+
+FastAPI backend for CreatorPulse India: creator discovery, channel profiles,
+niche-demand forecasts, and brand → creator matching over a YouTube Data API
+corpus of 12,547 Indian creators.
+
+**Endpoints**
+
+- `GET /healthz` — liveness
+- `GET /stats` — corpus summary
+- `GET /creators?q=&limit=` — search creators
+- `GET /creators/{channel_id}` — single creator profile
+- `GET /niches/{niche}/forecast` — niche demand forecast
+- `POST /match` — rank creators for a campaign brief (semantic fit, niche overlap,
+  fraud risk, budget fit, reach)
+
+Built by [Ayush Gupta](https://github.com/ayushgupta07xx).