README.md

metadata

title: Parkinsons Disease Prediction
emoji: 🧠
colorFrom: indigo
colorTo: purple
sdk: gradio
sdk_version: 3.32.0
app_file: app.py
pinned: false

Parkinson's Disease Prediction API

This Hugging Face Space hosts a machine learning model that predicts the risk of Parkinson's disease based on clinical symptoms and risk factors.

API Usage

The API accepts both GET and POST requests with the following parameters:

• gender: "Male" or "Female"
• age: Numerical age in years
• tremor: 0 (No) or 1 (Yes)
• stiffness: 0 (No) or 1 (Yes)
• balance_problems: 0 (No) or 1 (Yes)
• slow_movement: 0 (No) or 1 (Yes)
• sleep_issues: 0 (No) or 1 (Yes)
• tremor_severity: 0-10 scale
• tremor_frequency: "none", "rare", "occasional", "frequent", or "constant"
• family_history: 0 (No) or 1 (Yes)
• symptom_duration: Duration in months

Example Request

curl -X POST "https://abdullah1211-ml-parkinsons.hf.space/api/predict" \
  -H "Content-Type: application/json" \
  -d '{
    "gender": "Male",
    "age": 65,
    "tremor": 1,
    "stiffness": 1,
    "balance_problems": 0,
    "slow_movement": 1,
    "sleep_issues": 0,
    "tremor_severity": 7,
    "tremor_frequency": "frequent",
    "family_history": 1,
    "symptom_duration": 12
  }'

Example Response

{
  "probability": 0.78,
  "prediction": "High Risk",
  "parkinsons_prediction": 1,
  "using_model": true,
  "risk_factors": [
    "Senior age (65+)",
    "Presence of tremor",
    "Severe tremor",
    "Frequent tremor",
    "Muscle stiffness",
    "Slowness of movement (bradykinesia)",
    "Family history of Parkinson's disease",
    "Sustained symptoms (1+ year)",
    "Male gender (higher risk)"
  ],
  "execution_time_ms": 156,
  "model_version": "parkinsons-v1"
}

Risk Categories

• Low Risk: < 30% probability
• Moderate Risk: 30-60% probability
• High Risk: > 60% probability

Model Information

This model uses a Random Forest Classifier trained on clinical features to assess Parkinson's disease risk. It focuses on the core symptoms including tremor characteristics, movement issues, and known risk factors.

Integration with BrainWise App

This model serves as the backend for the BrainWise app's Parkinson's disease risk calculator, providing users with risk assessments based on their symptoms and health metrics.

Disclaimer

This model is for informational purposes only and should not replace professional medical advice. Always consult with healthcare providers for any concerns about Parkinson's disease or neurological symptoms.