create a docker container

.dockerignore

@@ -0,0 +1,9 @@
+venv/
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.env
+.git/
+.gitignore
+*.md

Dockerfile

@@ -0,0 +1,24 @@
+# ── Base image ────────────────────────────────────────────────────────────────
+FROM python:3.11-slim
+
+# ── System dependencies ────────────────────────────────────────────────────────
+# ffmpeg  : required for audio conversion (webm/ogg/mp3 → wav)
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    ffmpeg \
+ && rm -rf /var/lib/apt/lists/*
+
+# ── Working directory ──────────────────────────────────────────────────────────
+WORKDIR /app
+
+# ── Python dependencies ────────────────────────────────────────────────────────
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# ── Application source ─────────────────────────────────────────────────────────
+COPY . .
+
+# ── HF Spaces requires port 7860 ───────────────────────────────────────────────
+EXPOSE 7860
+
+# ── Entrypoint ─────────────────────────────────────────────────────────────────
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "7860"]

README.md

@@ -0,0 +1,59 @@
+---
+title: UPDRS API
+emoji: 🧠
+colorFrom: blue
+colorTo: purple
+sdk: docker
+app_port: 7860
+pinned: false
+---
+
+# Parkinson's Disease UPDRS Prediction API
+
+A FastAPI-based REST API that predicts a patient's **motor UPDRS score** (Unified Parkinson's Disease Rating Scale) from a voice recording.
+
+## Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| `GET` | `/` | Root welcome message |
+| `GET` | `/health` | Health check — confirms models are loaded |
+| `POST` | `/analyze/voice` | Main prediction endpoint |
+| `POST` | `/analyze/test` | Debug echo endpoint |
+
+## Usage — `/analyze/voice`
+
+Submit a `multipart/form-data` POST request with:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `name` | string | Patient name |
+| `age` | int | Age (11–119) |
+| `sex` | string | `male` or `female` |
+| `test_time` | float | Time since recruitment (days) |
+| `audio_file` | file | Voice recording (WAV, MP3, OGG, WebM) |
+
+### Response
+
+```json
+{
+  "prediction": 18.42,
+  "patient": "John Doe"
+}
+```
+
+`prediction` is the estimated motor UPDRS score (float).
+
+## Voice Features Extracted
+
+The API uses **Praat** (via `parselmouth`) to extract 16 acoustic biomarkers:
+- **Jitter**: `Jitter(%)`, `Jitter(Abs)`, `Jitter:RAP`, `Jitter:PPQ5`, `Jitter:DDP`
+- **Shimmer**: `Shimmer`, `Shimmer(dB)`, `Shimmer:APQ3`, `Shimmer:APQ5`, `Shimmer:APQ11`, `Shimmer:DDA`
+- **Noise**: `NHR`, `HNR`
+- **Nonlinear**: `RPDE`, `DFA`, `PPE`
+
+## Model
+
+- Hosted on HuggingFace: [`xplorers/parkinsons-updrs-model`](https://huggingface.co/xplorers/parkinsons-updrs-model)
+- Ensemble model (RandomForest + XGBoost + LightGBM via VotingRegressor)
+- Downloaded and cached in memory at startup

requirements.txt

@@ -2,13 +2,17 @@ annotated-doc==0.0.4
 annotated-types==0.7.0
 anyio==4.13.0
 certifi==2026.2.25
+cffi==2.0.0
 click==8.3.1
+decorator==5.2.1
 dnspython==2.8.0
 email-validator==2.3.0
 fastapi==0.135.2
 fastapi-cli==0.0.24
+ffmpeg-python==0.2.0
 filelock==3.25.2
 fsspec==2026.2.0
+future==1.0.0
 h11==0.16.0
 hf-xet==1.4.2
 httpcore==1.0.9
@@ -16,18 +20,23 @@ httptools==0.7.1
 httpx==0.28.1
 huggingface_hub==1.8.0
 idna==3.11
+ImageIO==2.37.3
+imageio-ffmpeg==0.6.0
 joblib==1.5.3
 lightgbm==4.6.0
 markdown-it-py==4.0.0
 mdurl==0.1.2
+moviepy==2.2.1
 numpy==2.4.3
 nvidia-nccl-cu12==2.29.7
 packaging==26.0
 pandas==3.0.1
+pillow==11.3.0
 praat-parselmouth==0.4.7
+proglog==0.1.12
+pycparser==3.0
 pydantic==2.12.5
 pydantic_core==2.41.5
-pydub==0.25.1
 Pygments==2.19.2
 python-dateutil==2.9.0.post0
 python-dotenv==1.2.2
@@ -39,6 +48,7 @@ scikit-learn==1.8.0
 scipy==1.17.1
 shellingham==1.5.4
 six==1.17.0
+soundfile==0.13.1
 starlette==1.0.0
 threadpoolctl==3.6.0
 tqdm==4.67.3