containerization with docker and updated the readmes

.dockerignore

@@ -0,0 +1,16 @@
+__pycache__
+*.pyc
+*.pyo
+*.pyd
+*.swp
+*.tmp
+.venv
+.env
+.git
+.gitignore
+Data
+outputs
+reports/*.pdf
+configs/*.secrets.*
+uv.lock
+code4change_analysis.egg-info

Dockerfile

@@ -0,0 +1,28 @@
+# syntax=docker/dockerfile:1
+FROM python:3.11-slim
+
+# Runtime system dependency for scikit-learn/scipy wheels
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends libgomp1 \
+    && rm -rf /var/lib/apt/lists/*
+
+# Python env hygiene
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PIP_NO_CACHE_DIR=1 \
+    PIP_DISABLE_PIP_VERSION_CHECK=1 \
+    PYTHONPATH=/app
+
+WORKDIR /app
+
+# Copy repo and install package (declared in pyproject.toml)
+COPY . .
+
+RUN pip install --upgrade pip setuptools wheel \
+    && pip install .
+
+# Streamlit default port
+EXPOSE 8501
+
+# Safe default: show CLI help
+CMD ["court-scheduler", "--help"]

README.md

@@ -41,6 +41,48 @@ uv run court-scheduler workflow --cases 10000 --days 384
 
 For a detailed walkthrough tailored for judges, see `docs/HACKATHON_SUBMISSION.md`.
 
+## Run with Docker (recommended for judges)
+
+If you prefer not to install Python or uv locally, use the provided Docker image.
+
+1) Build the image (run in repo root):
+
+```bash
+docker build -t code4change-analysis .
+```
+
+2) Show CLI help (Windows PowerShell example with volume mounts):
+
+```powershell
+docker run --rm `
+  -v ${PWD}\Data:/app/Data `
+  -v ${PWD}\outputs:/app/outputs `
+  code4change-analysis court-scheduler --help
+```
+
+3) Example CLI workflow:
+
+```powershell
+docker run --rm `
+  -v ${PWD}\Data:/app/Data `
+  -v ${PWD}\outputs:/app/outputs `
+  code4change-analysis court-scheduler workflow --cases 10000 --days 384
+```
+
+4) Run the Streamlit dashboard:
+
+```powershell
+docker run --rm -p 8501:8501 `
+  -v ${PWD}\Data:/app/Data `
+  -v ${PWD}\outputs:/app/outputs `
+  code4change-analysis `
+  streamlit run scheduler/dashboard/app.py --server.address=0.0.0.0
+```
+
+Then open http://localhost:8501.
+
+Notes for Windows CMD: use ^ for line continuation and replace ${PWD} with the full path.
+
 ## Data (DuckDB-first)
 
 This repository uses a DuckDB snapshot as the canonical raw dataset.

docs/HACKATHON_SUBMISSION.md

@@ -27,6 +27,41 @@ uv run streamlit run scheduler/dashboard/app.py
 
 **No pre-processing required** — EDA automatically loads `Data/court_data.duckdb` when present; if missing, it falls back to `ISDMHack_Cases_WPfinal.csv` and `ISDMHack_Hear.csv` placed in `Data/`.
 
+### Docker Quick Start (no local Python needed)
+
+If you prefer a zero-setup run, use Docker. This is the recommended path for judges.
+
+1) Build the image (from the repository root):
+
+```bash
+docker build -t code4change-analysis .
+```
+
+2) Show CLI help (Windows PowerShell example):
+
+```powershell
+docker run --rm `
+  -v ${PWD}\Data:/app/Data `
+  -v ${PWD}\outputs:/app/outputs `
+  code4change-analysis court-scheduler --help
+```
+
+3) Run the Streamlit dashboard:
+
+```powershell
+docker run --rm -p 8501:8501 `
+  -v ${PWD}\Data:/app/Data `
+  -v ${PWD}\outputs:/app/outputs `
+  code4change-analysis `
+  streamlit run scheduler/dashboard/app.py --server.address=0.0.0.0
+```
+
+Then open http://localhost:8501.
+
+Notes:
+- Replace ${PWD} with the full path if using Windows CMD (use ^ for line continuation).
+- Mounting Data/ and outputs/ ensures inputs and generated artifacts persist on your host.
+
 #### Alternative: CLI Workflow (for scripting)
 ```bash
 # Run complete pipeline: generate cases + simulate