|
|
--- |
|
|
license: mit |
|
|
language: en |
|
|
tags: |
|
|
- medical |
|
|
- config |
|
|
- med-vllm |
|
|
library_name: medvllm |
|
|
pipeline_tag: token-classification |
|
|
--- |
|
|
|
|
|
# Med vLLM (Config-first Repository) |
|
|
|
|
|
This repository serves as a config-first landing for the Med vLLM stack. |
|
|
|
|
|
It contains example configuration files and is intended to help users discover |
|
|
and consume the `MedicalModelConfig` from the Hub via `from_pretrained`, and to |
|
|
use these as starting points for training or inference in medical NLP tasks. |
|
|
|
|
|
## Contents |
|
|
|
|
|
- NER config example (`examples/ner/`) |
|
|
- Classification config example (`examples/classification/`) |
|
|
- Generation config example (`examples/generation/`) |
|
|
|
|
|
## Install |
|
|
|
|
|
```bash |
|
|
pip install medvllm |
|
|
``` |
|
|
|
|
|
## Quickstart (Python) |
|
|
|
|
|
```python |
|
|
from medvllm.medical.config.models.medical_config import MedicalModelConfig |
|
|
cfg = MedicalModelConfig.from_pretrained("Junaidi-AI/med-vllm") |
|
|
print(cfg.task_type) |
|
|
``` |
|
|
|
|
|
Or directly load a specific example folder if exported as a subfolder with |
|
|
its own config files. |
|
|
|
|
|
## Examples |
|
|
|
|
|
- NER: [`examples/ner/config.json`](./examples/ner/config.json) | [`examples/ner/config.yaml`](./examples/ner/config.yaml) |
|
|
- Classification: [`examples/classification/config.json`](./examples/classification/config.json) | [`examples/classification/config.yaml`](./examples/classification/config.yaml) |
|
|
- Generation: [`examples/generation/config.json`](./examples/generation/config.json) | [`examples/generation/config.yaml`](./examples/generation/config.yaml) |
|
|
|
|
|
Use these as starting points and customize fields like `task_type`, `classification_labels`, `medical_entity_types`, and domain settings. |
|
|
|
|
|
## Tasks supported |
|
|
|
|
|
- Named Entity Recognition (NER) |
|
|
- Text Classification |
|
|
- Text Generation |
|
|
|
|
|
All tasks share a unified configuration schema via `MedicalModelConfig`. |
|
|
|
|
|
## Weights roadmap |
|
|
|
|
|
This repo currently focuses on configs. Model weights/adapters will be added progressively: |
|
|
|
|
|
- BioBERT/ClinicalBERT adapters |
|
|
- Task-specific fine-tuned checkpoints (NER/Classification) |
|
|
|
|
|
Follow the repo for updates or open a Discussion to request specific checkpoints. |
|
|
|
|
|
## Debug and logging |
|
|
|
|
|
By default, verbose config debug prints are silenced. To enable them for troubleshooting, set: |
|
|
|
|
|
```bash |
|
|
export MEDVLLM_CONFIG_DEBUG=1 |
|
|
``` |
|
|
|
|
|
## Medical Disclaimer |
|
|
|
|
|
This repository and associated configurations are provided for research and |
|
|
engineering purposes only. They are not intended for clinical decision-making. |
|
|
Always involve qualified healthcare professionals and ensure compliance with |
|
|
applicable regulations (e.g., HIPAA, GDPR). Avoid using PHI/PII. |
|
|
|
|
|
## License |
|
|
|
|
|
MIT |
|
|
|