QUICK_START.md

# Quick Start Guide - Downloading Real Medical Images

<!--
Medical Imaging Dataset - Quick Start Guide
===========================================

Project: Medical Imaging Dataset
Website: https://rskworld.in
Contact: help@rskworld.in, support@rskworld.in
Phone: +91 93305 39277
Founder: Molla Samser
Designer & Tester: Rima Khatun
-->

## Easiest Way to Get Real Medical Images

### Option 1: COVID-19 Chest X-ray Dataset (No Account Required) ⭐ RECOMMENDED

This is the **easiest** dataset to download - no registration needed!

```bash
# Run the GitHub downloader
python download_from_github.py
# Select option 1

# Or download manually:
# Visit: https://github.com/ieee8023/covid-chestxray-dataset
# Click "Code" → "Download ZIP"
# Extract and copy images to data/xray/images/
```

**What you get**: ~100+ real chest X-ray images with COVID-19 cases

---

### Option 2: Kaggle Datasets (Requires Free Account)

1. **Create free Kaggle account**: https://www.kaggle.com
2. **Get API key**:
- Go to Account Settings → API
- Click "Create New API Token"
- Download `kaggle.json`
3. **Install Kaggle API**:
```bash
pip install kaggle
```
4. **Setup credentials**:
- Windows: Place `kaggle.json` in `C:\Users\YourUsername\.kaggle\`
- Linux/Mac: Place in `~/.kaggle/` and run `chmod 600 ~/.kaggle/kaggle.json`
5. **Download dataset**:
```bash
kaggle datasets download -d paultimothymooney/chest-xray-pneumonia
unzip chest-xray-pneumonia.zip -d data/
```

**What you get**: ~5,863 real chest X-ray images

---

### Option 3: MedMNIST (Direct Download)

1. Visit: https://medmnist.com/
2. Click "Download" on any dataset
3. Extract and organize images

**What you get**: ~66,000 standardized medical images across multiple modalities

---

## Recommended Datasets for Beginners

1. **COVID-19 X-ray Dataset** (GitHub) - Easiest, no account needed
2. **Chest X-Ray Pneumonia** (Kaggle) - Large, well-organized
3. **Brain MRI Tumor Detection** (Kaggle) - Good for MRI examples
4. **MedMNIST** (Official site) - Pre-processed, ready to use

## After Downloading

1. **Organize images** into the project structure:
```
data/
├── xray/images/ ← Place X-ray images here
├── ct_scan/images/ ← Place CT scan images here
└── mri/images/ ← Place MRI images here
```

2. **Create label files** (optional):
- Copy example labels from `data/xray/labels/example_label.json`
- Modify for your images

3. **Test the dataset**:
```bash
python example_usage.py
```

## Need Help?

- Read full instructions: `DOWNLOAD_INSTRUCTIONS.md`
- Check dataset licenses and terms
- Contact: help@rskworld.in

---

**Remember**: All datasets are for **educational purposes only**. Not for medical diagnosis.