Upload MedAssist-LLM best model (epoch_100) with evaluation results
Browse files- README.md +98 -0
- config.json +10 -0
- figures/fig1.png +0 -0
- figures/fig2.png +0 -0
- figures/fig3.png +0 -0
- pytorch_model.bin +3 -0
README.md
ADDED
|
@@ -0,0 +1,98 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: apache-2.0
|
| 3 |
+
library_name: transformers
|
| 4 |
+
---
|
| 5 |
+
# MedAssist-LLM
|
| 6 |
+
<!-- markdownlint-disable first-line-h1 -->
|
| 7 |
+
<!-- markdownlint-disable html -->
|
| 8 |
+
<!-- markdownlint-disable no-duplicate-header -->
|
| 9 |
+
|
| 10 |
+
<div align="center">
|
| 11 |
+
<img src="figures/fig1.png" width="60%" alt="MedAssist-LLM" />
|
| 12 |
+
</div>
|
| 13 |
+
<hr>
|
| 14 |
+
|
| 15 |
+
<div align="center" style="line-height: 1;">
|
| 16 |
+
<a href="LICENSE" style="margin: 2px;">
|
| 17 |
+
<img alt="License" src="figures/fig2.png" style="display: inline-block; vertical-align: middle;"/>
|
| 18 |
+
</a>
|
| 19 |
+
</div>
|
| 20 |
+
|
| 21 |
+
## 1. Introduction
|
| 22 |
+
|
| 23 |
+
MedAssist-LLM is a specialized healthcare language model designed for clinical decision support and medical knowledge assistance. This model has been fine-tuned on extensive medical literature, clinical notes, and healthcare datasets to provide accurate and reliable medical information assistance.
|
| 24 |
+
|
| 25 |
+
<p align="center">
|
| 26 |
+
<img width="80%" src="figures/fig3.png">
|
| 27 |
+
</p>
|
| 28 |
+
|
| 29 |
+
The model excels at understanding complex medical terminology, interpreting clinical scenarios, and providing evidence-based recommendations. It has been evaluated across multiple healthcare benchmarks including clinical diagnosis, drug interactions, and medical question answering.
|
| 30 |
+
|
| 31 |
+
**Important**: This model is designed to assist healthcare professionals and should not replace professional medical judgment. Always consult qualified healthcare providers for medical decisions.
|
| 32 |
+
|
| 33 |
+
## 2. Evaluation Results
|
| 34 |
+
|
| 35 |
+
### Comprehensive Medical Benchmark Results
|
| 36 |
+
|
| 37 |
+
<div align="center">
|
| 38 |
+
|
| 39 |
+
| | Benchmark | BioMedLM | ClinicalBERT | MedPaLM | MedAssist-LLM |
|
| 40 |
+
|---|---|---|---|---|---|
|
| 41 |
+
| **Clinical Tasks** | Clinical Diagnosis | 0.623 | 0.651 | 0.712 | 0.660 |
|
| 42 |
+
| | Drug Interaction | 0.589 | 0.612 | 0.678 | 0.671 |
|
| 43 |
+
| | Adverse Event Detection | 0.534 | 0.567 | 0.623 | 0.696 |
|
| 44 |
+
| **Knowledge Tasks** | Medical Q&A | 0.701 | 0.723 | 0.789 | 0.750 |
|
| 45 |
+
| | Medical Literature Comprehension | 0.645 | 0.678 | 0.734 | 0.675 |
|
| 46 |
+
| | EHR Understanding | 0.567 | 0.598 | 0.656 | 0.679 |
|
| 47 |
+
| **Diagnostic Tasks** | Radiology Analysis | 0.512 | 0.545 | 0.612 | 0.581 |
|
| 48 |
+
| | Pathology Classification | 0.578 | 0.601 | 0.667 | 0.713 |
|
| 49 |
+
| | Patient Risk Assessment | 0.523 | 0.556 | 0.623 | 0.711 |
|
| 50 |
+
| **Clinical Support** | Treatment Recommendation | 0.612 | 0.645 | 0.701 | 0.744 |
|
| 51 |
+
| | Medical Coding | 0.489 | 0.523 | 0.589 | 0.570 |
|
| 52 |
+
| | Clinical Notes Summarization | 0.634 | 0.667 | 0.723 | 0.761 |
|
| 53 |
+
|
| 54 |
+
</div>
|
| 55 |
+
|
| 56 |
+
### Overall Performance Summary
|
| 57 |
+
MedAssist-LLM demonstrates strong performance across all medical benchmark categories, with particularly notable results in clinical decision support and medical knowledge tasks.
|
| 58 |
+
|
| 59 |
+
## 3. Clinical API Access
|
| 60 |
+
We offer a secure API for healthcare institutions to integrate MedAssist-LLM. Please contact our team for enterprise access and HIPAA-compliant deployment options.
|
| 61 |
+
|
| 62 |
+
## 4. How to Run Locally
|
| 63 |
+
|
| 64 |
+
Please refer to our code repository for detailed instructions on running MedAssist-LLM in your clinical environment.
|
| 65 |
+
|
| 66 |
+
### Security Considerations
|
| 67 |
+
1. This model processes sensitive medical data. Ensure proper data handling procedures.
|
| 68 |
+
2. Deploy in HIPAA-compliant infrastructure when processing PHI.
|
| 69 |
+
3. Implement appropriate access controls and audit logging.
|
| 70 |
+
|
| 71 |
+
### System Prompt
|
| 72 |
+
We recommend using the following system prompt:
|
| 73 |
+
```
|
| 74 |
+
You are MedAssist-LLM, a medical AI assistant designed to support healthcare professionals.
|
| 75 |
+
Today is {current date}.
|
| 76 |
+
Important: Always recommend consulting qualified healthcare providers for medical decisions.
|
| 77 |
+
```
|
| 78 |
+
|
| 79 |
+
### Temperature
|
| 80 |
+
We recommend setting the temperature parameter to 0.3 for medical applications to ensure consistent and reliable outputs.
|
| 81 |
+
|
| 82 |
+
### Prompts for Clinical Documents
|
| 83 |
+
For clinical document analysis:
|
| 84 |
+
```
|
| 85 |
+
clinical_template = \
|
| 86 |
+
"""[Document Type]: {doc_type}
|
| 87 |
+
[Patient Context]: {patient_context}
|
| 88 |
+
[Clinical Content Begin]
|
| 89 |
+
{clinical_content}
|
| 90 |
+
[Clinical Content End]
|
| 91 |
+
{query}"""
|
| 92 |
+
```
|
| 93 |
+
|
| 94 |
+
## 5. License
|
| 95 |
+
This code repository is licensed under the [Apache 2.0 License](LICENSE). Use of MedAssist-LLM in clinical settings requires compliance with applicable healthcare regulations.
|
| 96 |
+
|
| 97 |
+
## 6. Contact
|
| 98 |
+
For questions or enterprise inquiries, please contact us at support@medassist-llm.health.
|
config.json
ADDED
|
@@ -0,0 +1,10 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"model_type": "llama",
|
| 3 |
+
"architectures": [
|
| 4 |
+
"LlamaForCausalLM"
|
| 5 |
+
],
|
| 6 |
+
"hidden_size": 4096,
|
| 7 |
+
"num_attention_heads": 32,
|
| 8 |
+
"num_hidden_layers": 32,
|
| 9 |
+
"vocab_size": 32000
|
| 10 |
+
}
|
figures/fig1.png
ADDED
|
figures/fig2.png
ADDED
|
figures/fig3.png
ADDED
|
pytorch_model.bin
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:2704b4ff968d3c6124109066db38f189838ed72317d63c76298a2a8a8bacb85a
|
| 3 |
+
size 74
|