Add Hugging Face Space deployment support

.dockerignore

@@ -0,0 +1,12 @@
+.git
+.github
+.venv
+.local
+.pytest_cache
+__pycache__
+*.pyc
+data
+masterman
+htmlcov
+.coverage
+README_HF_DRAFT.md

Dockerfile

@@ -0,0 +1,18 @@
+FROM python:3.11-slim
+
+ENV PYTHONUNBUFFERED=1
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV SUBSCRIPTION_PIPELINE_ENGINE=pandas
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+RUN python run_pipeline.py --records 50000 --skip-benchmark
+
+EXPOSE 7860
+
+CMD ["python", "-m", "uvicorn", "src.web.app:app", "--host", "0.0.0.0", "--port", "7860"]

README.md

@@ -151,6 +151,17 @@ python run_dashboard.py
 The launcher starts a FastAPI server on the first available local port from
 `8000` onward.
 
+### Hugging Face Space / Docker
+
+The repository includes a Dockerfile for Hugging Face Spaces. The container
+build generates a 50K-record demo dataset and serves the dashboard on port
+`7860`.
+
+```bash
+docker build -t subscription-intelligence-pipeline .
+docker run -p 7860:7860 subscription-intelligence-pipeline
+```
+
 ### Tests
 
 ```bash