================================================================================
HUGGINGFACE SPACES - QUICK START GUIDE
================================================================================

FIXED: Import errors resolved! App will not crash on missing files.

================================================================================
STEP 1: CREATE SPACE
================================================================================

Go to: https://huggingface.co/new-space

Settings:
  SDK:       Gradio
  Hardware:  GPU (T4)    ← IMPORTANT!

================================================================================
STEP 2: UPLOAD THESE FILES
================================================================================

REQUIRED (9 files minimum):

  [✓] app.py
  [✓] llm.py
  [✓] extractors.py
  [✓] tagging.py
  [✓] chunking.py
  [✓] validation.py
  [✓] reporting.py
  [✓] dashboard.py
  [✓] requirements.txt

OPTIONAL (recommended):

  [ ] production_logger.py
  [ ] quote_extractor.py

================================================================================
STEP 3: WAIT FOR BUILD
================================================================================

First time: ~5-10 minutes
  - Installing dependencies
  - Downloading Phi-3-mini model

Watch "Logs" tab for:
  ✅ Model loaded on cuda:0
  ✅ Running on local URL

================================================================================
STEP 4: TEST
================================================================================

1. Upload a transcript (DOCX or PDF)
2. Select "HCP" interviewee type
3. Click "Analyze Transcripts"
4. Wait ~5-10 minutes

Expected: Quality Score 0.7-1.0 (not 0.00!)

================================================================================
TROUBLESHOOTING
================================================================================

Still getting ModuleNotFoundError?
→ Make sure you uploaded the UPDATED app.py

Very slow processing?
→ Check Hardware is set to GPU (not CPU)

Quality Score 0.00?
→ Settings → Variables → Add DEBUG_MODE=True
→ Check logs for error messages

================================================================================
YOU'RE READY!
================================================================================

Just upload the 9-11 files and it works.
No .env needed. No terminal commands needed.

================================================================================