# 🚀 DEPLOYMENT GUIDE

## Deploy to Hugging Face Spaces (FREE)

### Step 1: Create Hugging Face Account
1. Go to https://huggingface.co
2. Sign up (free)
3. Verify email

### Step 2: Create New Space
1. Click your profile → "New Space"
2. Settings:
   - **Name:** `anemia-screening` (or your choice)
   - **License:** MIT
   - **SDK:** Gradio
   - **Hardware:** CPU Basic (free) — upgrade to GPU if slow
   - **Visibility:** Public (or Private)
3. Click "Create Space"

### Step 3: Upload Files
Upload these files to your Space:

```
your-space/
├── app.py                  # Main application (provided)
├── requirements.txt        # Dependencies (provided)
├── README.md              # Space config (provided)
├── model.pkl              # YOUR trained model from Colab
└── best.pt                # YOUR YOLO weights
```

**Option A: Via Web Interface**
- Click "Files" tab → "Add file" → Upload each file

**Option B: Via Git**
```bash
git clone https://huggingface.co/spaces/YOUR_USERNAME/anemia-screening
cd anemia-screening
# Copy your files here
git add .
git commit -m "Initial deployment"
git push
```

### Step 4: Wait for Build
- Space will automatically install dependencies and start
- Takes 2-5 minutes
- Check "Logs" tab if errors occur

### Step 5: Test
- Once running, test with a sample image
- Share the URL with others

---

## Files You Need from Colab

After Colab finishes, download from your GDrive `outputs/` folder:

| File | What it is |
|------|------------|
| `model.pkl` | Trained ML model |

You already have:
| File | What it is |
|------|------------|
| `best.pt` | YOLO segmentation weights |

---

## Common Issues

### "Model not found"
- Ensure `model.pkl` and `best.pt` are in the root of your Space (not in a subfolder)

### "Out of memory"
- Upgrade to GPU hardware (still free tier available)
- Or reduce image size in `app.py`

### "Module not found"
- Check `requirements.txt` has all dependencies
- Restart the Space

### YOLO errors
- Ensure `best.pt` is a segmentation model (not detection-only)
- Check ultralytics version compatibility

---

## Custom Domain (Optional)

Hugging Face provides URL like:
`https://huggingface.co/spaces/YOUR_USERNAME/anemia-screening`

For custom domain (e.g., `anemia.yourdomain.com`):
1. Go to Space Settings
2. Add custom domain
3. Configure DNS CNAME record

---

## Data Collection

Collected data saves to `collected_data.csv` in the Space.

To download:
1. Go to "Files" tab
2. Click `collected_data.csv`
3. Download

For production, connect to Google Sheets or a database instead.

---

## Updating the Model

When you retrain with more data:
1. Download new `model.pkl` from Colab
2. Upload to Space (replace old file)
3. Space auto-restarts

---

## Cost

| Tier | Cost | Specs |
|------|------|-------|
| CPU Basic | FREE | 2 vCPU, 16GB RAM |
| CPU Upgrade | $0.03/hr | 8 vCPU, 32GB RAM |
| GPU T4 | $0.40/hr | Good for heavy YOLO usage |

For most use cases, **FREE tier is sufficient**.