| ================================================================================ |
| 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. |
|
|
| ================================================================================ |
|
|
