MedM-VL: What Makes a Good Medical LVLM?

MedM-VL is a modular, LLaVA-based codebase for medical LVLMs, supporting flexible customization of encoders, connectors, and LLMs.

MedM-VL focuses on small-scale medical LVLMs, designed for direct deployment in real-world medical scenarios or efficient fine-tuning on downstream tasks.

:newspaper: News

• [2025.07.29]: The technical report has been accepted by MICCAI2025 workshop (MLLMCP).
• [2025.04.10]: The model weights (v1.0) have been uploaded to Hugging Face.
  • shiym2000/MedM-VL-2D-3B-en · Hugging Face
  • shiym2000/MedM-VL-CT-Chest-3B-en · Hugging Face
  • shiym2000/MedM-CLIP-CT · Hugging Face
• [2025.04.06]: The technical report has been released on arXiv.
  • [2504.04323] MedM-VL: What Makes a Good Medical LVLM?
• [2024.12.19]: The complete code has been released on GitHub.

:sparkles: Features

MedM-VL (v1.0: single image input, more details on Hugging Face)

• shiym2000/MedM-VL-2D-3B-en · Hugging Face: Trained on 2D medical images and English medical texts.
• shiym2000/MedM-VL-CT-Chest-3B-en · Hugging Face: Trained on 3D chest CT volumes and English medical texts.

:package: Installation

# 1. clone and navigate
git clone https://github.com/MSIIP/MedM-VL.git
cd MedM-VL

# 2. create a conda environment, activate it and install packages
conda create -n medm python=3.10
conda activate medm
pip install -r requirements.txt
pip install flash-attn --no-build-isolation

:rocket: Getting Started

If you are confused about some parameters during usage, please refer to Parameter Interpretation.

1. Train a general medical LVLM from scratch

# For 2D medical LVLMs
# 1. pre-train (annotation format: examples/data/pretrain_2d.json)
bash examples/MedM-VL-2D/pretrain_en.sh
# 2. fine-tune (annotation format: examples/data/finetune_2d.json)
bash examples/MedM-VL-2D/finetune_en.sh

# For 3D medical LVLMs
# 1. pre-train (annotation format: examples/data/pretrain_3d.json)
bash examples/MedM-VL-CT-Chest/pretrain_en.sh
# 2. fine-tune (annotation format: examples/data/finetune_3d.json)
bash examples/MedM-VL-CT-Chest/finetune_en.sh

# In fact, there is no difference in the annotation file format between
# pre-training and fine-tuning. The former is from image-text pairs
# while the latter refers to instruction tuning data.

2. Fine-tune a specialized medical LVLM with pre-trained weights

# For 2D medical LVLMs
# 1. download weights from Hugging Face
pip install -U huggingface_hub
huggingface-cli download --resume-download shiym2000/MedM-VL-2D-3B-en --local-dir work_dirs/MedM-VL-2D-3B-en
# 2. fine-tune using LoRA (annotation format: examples/data/finetune_2d.json)
bash examples/finetune_2d.sh

# For 3D medical LVLMs
# 1. download weights from Hugging Face
pip install -U huggingface_hub
huggingface-cli download --resume-download shiym2000/MedM-VL-CT-Chest-3B-en --local-dir work_dirs/MedM-VL-CT-Chest-3B-en
# 2. fine-tune using LoRA (annotation format: examples/data/finetune_3d.json)
bash examples/finetune_3d.sh

# You can choose full or LoRA fine-tuning based on available GPU memory.

3. Inference

# For 2D medical LVLMs
# inference (annotation format: examples/data/inference_2d.json)
bash examples/inference_2d.sh

# For 3D medical LVLMs
# inference (annotation format: examples/data/inference_3d.json)
bash examples/inference_3d.sh

# Compared to `finetune.json``, `conversations` in `inference.json` lacks
# the final response, which will be generated by the model.

4. Demo

# Launch a Gradio demo locally.
bash examples/playground.sh

:robot: Model Zoo

:book: Citation

@inproceedings{shi2025medm,
  title={Medm-vl: What makes a good medical lvlm?},
  author={Shi, Yiming and Yang, Shaoshuai and Zhu, Xun and Wang, Haoyu and Fu, Xiangling and Li, Miao and Wu, Ji},
  booktitle={International Workshop on Agentic AI for Medicine},
  pages={290--299},
  year={2025},
  organization={Springer}
}

:heart: Acknowledgements

We would like to express our gratitude to the following resources:

• TinyLLaVA_Factory - An open-source modular codebase for small-scale large multimodal models (LMMs).