Add MIMIC-CXR subdir README with citations

mimic-cxr/README.md

@@ -2,25 +2,105 @@
 license: apache-2.0
 library_name: peft
 base_model: lmsys/vicuna-7b-v1.5
+pipeline_tag: image-to-text
 tags:
   - medical-imaging
   - chest-xray
   - mimic-cxr
+  - vision-language
   - fairness
   - lora
+  - peft
+datasets:
+  - physionet/mimic-cxr-jpg
 ---
 
 # FairLLaVA — MIMIC-CXR
 
 Fairness-aware LoRA adapter on top of LLaVA-Rad (Vicuna-7B + BiomedCLIP-CXR-518)
-for MIMIC-CXR chest-X-ray report generation. Trained with the FairLLaVA
-mutual-information regularizer on patient demographics (age, sex, race).
+for **MIMIC-CXR** chest-X-ray report generation. Trained with the FairLLaVA
+mutual-information regularizer on patient demographics (age, sex, race) to
+reduce inter-group performance gaps while preserving clinical accuracy.
 
-## Files
-- `adapter_model.safetensors`, `adapter_config.json`, `non_lora_trainables.bin` — LoRA weights
-- `mm_projector.bin` — multimodal projector
-- `tokenizer.model`, `tokenizer_config.json`, `special_tokens_map.json`, `config.json` — tokenizer / config
+Code: [github.com/bhosalems/FairLLaVA](https://github.com/bhosalems/FairLLaVA)
+Paper: [arxiv.org/abs/2603.26008](https://arxiv.org/abs/2603.26008)
 
-## Usage
-See https://github.com/bhosalems/FairLLaVA → `inference.py`. Point `model_path` at
-this directory and set `model_base="lmsys/vicuna-7b-v1.5"`.
+## Files in this directory
+
+| File | Purpose |
+|---|---|
+| `adapter_model.safetensors`, `adapter_config.json` | LoRA adapter weights + config |
+| `non_lora_trainables.bin` | non-LoRA trainable params (projector + token embeddings) |
+| `mm_projector.bin` | multimodal projector (vision -> LLM token space) |
+| `config.json` | LLaVA model config |
+| `tokenizer.model`, `tokenizer_config.json`, `special_tokens_map.json` | Vicuna tokenizer |
+
+## Quick start
+
+```python
+from huggingface_hub import snapshot_download
+from llava.model.builder import load_pretrained_model
+
+local_dir = snapshot_download(
+    repo_id="mbhosale/FairLLaVA",
+    allow_patterns="mimic-cxr/*",
+)
+
+tokenizer, model, image_processor, ctx_len = load_pretrained_model(
+    f"{local_dir}/mimic-cxr",
+    model_base="lmsys/vicuna-7b-v1.5",
+    model_name="llavarad",
+)
+```
+
+See the full inference example in [`inference.py`](https://github.com/bhosalems/FairLLaVA/blob/main/inference.py).
+
+## Ethics
+
+This checkpoint is released **for research and educational use only**. It is
+**not** approved or validated for clinical or diagnostic use and must not be
+used to make medical decisions or to inform patient care. Use of MIMIC-CXR is
+governed by the PhysioNet data-use agreement.
+
+## Citation
+
+If you use this checkpoint, please cite FairLLaVA and the upstream works it builds on:
+
+```bibtex
+@misc{bhosale2026fairllava,
+  title={FairLLaVA: Fairness-Aware Parameter-Efficient Fine-Tuning for Large Vision-Language Assistants},
+  author={Mahesh Bhosale and Abdul Wasi and Shantam Srivastava and Shifa Latif and Tianyu Luan and Mingchen Gao and David Doermann and Xuan Gong},
+  year={2026},
+  eprint={2603.26008},
+  archivePrefix={arXiv},
+  primaryClass={cs.CV},
+  url={https://arxiv.org/abs/2603.26008}
+}
+
+@article{ZambranoChaves2025,
+  title={A clinically accessible small multimodal radiology model and evaluation metric for chest X-ray findings},
+  author={Zambrano Chaves, Juan Manuel and others},
+  journal={Nature Communications}, year={2025}, volume={16}, pages={3108},
+  doi={10.1038/s41467-025-58344-x}
+}
+
+@misc{liu2023improvedllava,
+  title={Improved Baselines with Visual Instruction Tuning},
+  author={Liu, Haotian and Li, Chunyuan and Li, Yuheng and Lee, Yong Jae},
+  publisher={arXiv:2310.03744},
+  year={2023}
+}
+
+@article{johnson2019mimic,
+  title={MIMIC-CXR, a de-identified publicly available database of chest radiographs with free-text reports},
+  author={Johnson, Alistair E. W. and Pollard, Tom J. and Berkowitz, Seth J. and Greenbaum, Nathaniel R. and Lungren, Matthew P. and Deng, Chih-ying and Mark, Roger G. and Horng, Steven},
+  journal={Scientific Data}, year={2019}, volume={6}, number={1}, pages={317},
+  doi={10.1038/s41597-019-0322-0}
+}
+
+@article{johnson2019mimiccxrjpg,
+  title={MIMIC-CXR-JPG, a large publicly available database of labeled chest radiographs},
+  author={Johnson, Alistair E. W. and Pollard, Tom J. and Greenbaum, Nathaniel R. and Lungren, Matthew P. and Deng, Chih-ying and Peng, Yifan and Lu, Zhiyong and Mark, Roger G. and Berkowitz, Seth J. and Horng, Steven},
+  journal={arXiv preprint arXiv:1901.07042}, year={2019}
+}
+```