README.md

---
title: Symptom Checker API
emoji: 🩺
colorFrom: blue
colorTo: green
sdk: docker
pinned: false
license: mit
app_port: 7860
---

# Symptom Checker API

AI-powered symptom checker using XGBoost machine learning model.

## API Endpoints

### Health Check
- **GET** `/` - Check if API is running

### Get Available Symptoms
- **GET** `/api/symptoms` - Returns list of all symptoms the model recognizes

### Check Symptoms
- **POST** `/api/check-symptoms` - Analyze symptoms and get disease predictions

#### Request Body:
```json
{
  "symptoms": ["fever", "cough", "headache"]
}
```

#### Response:
```json
{
  "success": true,
  "predictions": [
    {
      "rank": 1,
      "disease": "Disease Name",
      "confidence": 0.85,
      "confidence_percent": "85.00%"
    }
  ],
  "input_symptoms": ["fever", "cough", "headache"],
  "error": null
}
```

## Documentation

Visit `/docs` for interactive Swagger documentation.