Create README.md
Browse files
README.md
ADDED
|
@@ -0,0 +1,69 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# AI Medical Research Assistant Prototype
|
| 2 |
+
|
| 3 |
+
⚠️ **This is a research prototype only - NOT FOR MEDICAL USE** ⚠️
|
| 4 |
+
|
| 5 |
+
## Project Description
|
| 6 |
+
A proof-of-concept AI system demonstrating:
|
| 7 |
+
- Medical image analysis (X-rays, CT scans)
|
| 8 |
+
- Prescription text parsing
|
| 9 |
+
- Research-backed medical Q&A using DeepSeek
|
| 10 |
+
- Safety guardrails for medical content
|
| 11 |
+
|
| 12 |
+
## Features
|
| 13 |
+
- 📷 Basic medical image analysis
|
| 14 |
+
- 💊 Prescription medication extraction
|
| 15 |
+
- 🔍 Research-supported responses
|
| 16 |
+
- ⚠️ Automatic safety filtering
|
| 17 |
+
|
| 18 |
+
## Setup Instructions
|
| 19 |
+
|
| 20 |
+
1. **Hugging Face Secrets**:
|
| 21 |
+
- Add your DeepSeek API key as a secret:
|
| 22 |
+
- Name: `DEEPSEEK_API_KEY`
|
| 23 |
+
- Value: [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]
|
| 24 |
+
|
| 25 |
+
2. **Required Models**:
|
| 26 |
+
- Will auto-download on first run:
|
| 27 |
+
- `obi/deid_bert_i2b2` (Prescription parser)
|
| 28 |
+
- `Hate-speech-CNERG/dehatebert-mono-english` (Safety filter)
|
| 29 |
+
- TorchXRayVision models
|
| 30 |
+
|
| 31 |
+
3. **Hardware Requirements**:
|
| 32 |
+
- GPU Space recommended
|
| 33 |
+
- Minimum 8GB RAM
|
| 34 |
+
|
| 35 |
+
## Usage
|
| 36 |
+
1. Input options:
|
| 37 |
+
- Medical question (text)
|
| 38 |
+
- Medical images (X-ray/CT scans)
|
| 39 |
+
- Prescription text
|
| 40 |
+
|
| 41 |
+
2. Output:
|
| 42 |
+
- Research-supported response with safety disclaimers
|
| 43 |
+
|
| 44 |
+
## Models Used
|
| 45 |
+
| Component | Model/API | Source |
|
| 46 |
+
|------------------------|-------------------------------------|-----------------------------------|
|
| 47 |
+
| Medical Q&A | DeepSeek API | https://deepseek.com |
|
| 48 |
+
| Prescription Parsing | `obi/deid_bert_i2b2` | Hugging Face Model Hub |
|
| 49 |
+
| X-ray Analysis | DenseNet121 | TorchXRayVision |
|
| 50 |
+
| Safety Filter | `dehatebert-mono-english` | Hugging Face Model Hub |
|
| 51 |
+
|
| 52 |
+
## Legal Disclaimer
|
| 53 |
+
THIS SYSTEM:
|
| 54 |
+
- ❌ Is NOT a medical device
|
| 55 |
+
- ❌ Cannot diagnose conditions
|
| 56 |
+
- ❌ Should NOT be used for treatment decisions
|
| 57 |
+
- ✅ For research purposes only
|
| 58 |
+
|
| 59 |
+
Consult licensed healthcare professionals for medical advice.
|
| 60 |
+
|
| 61 |
+
## Limitations
|
| 62 |
+
- Image analysis uses placeholder implementations
|
| 63 |
+
- Prescription parsing limited to English text
|
| 64 |
+
- Responses require clinical validation
|
| 65 |
+
- No HIPAA compliance implemented
|
| 66 |
+
|
| 67 |
+
---
|
| 68 |
+
|
| 69 |
+
**Warning**: This prototype contains simulated medical AI components. Actual medical AI systems require regulatory approval and clinical validation.
|