Generating clinical reports that summarize abnormal patterns, diagnostic findings, and clinical interpretations from long-term EEG recordings remains labor-intensive. We curate a largescale clinical EEG dataset with 9,922 reports paired with approximately 11,000 hours of EEG recordings from 9,048 patients.
We therefore develop CELM, the first clinical EEG-to-Language foundation model capable of summarizing longduration, variable-length EEG recordings and performing end-to-end clinical report generation at multiple scales, including recording description, background activity, epileptiform abnormalities, events/seizures, and impressions. Experimental results show that, with patient history supervision, our method achieves 70%–95% average relative improvements in standard generation metrics (e.g., ROUGE-1 and METEOR) from 0.2–0.3to 0.4–0.6. In the zero-shot setting without patient history, CELM attains generation scores in the range of 0.43–0.52, compared to baselines of 0.17–0.26. CELM integrates pretrained EEG foundation models with language models to enable scalable multimodal learning. We release our model and benchmark construction pipeline in this repository.
- [Work in Progress] releasing model on HuggingFace.
- [2026-03-05] Code released on GitHub!
- [2026-03-02] Accepted to ICLR 2026 Workshop MM Intelligence!
- [2026-01-29] Preprint released on arXiv!
| Setting | Metric | Best Baseline | CELM |
|---|---|---|---|
| With patient history - S0001 | ROUGE-1 | 0.3038 | 0.5565 (83% relative improvement) |
| With patient history - S0002 | ROUGE-1 | 0.2886 | 0.6408 (122% relative improvement) |
| Zero-context (EEG only input) - S0002 | ROUGE-1 | 0.2557 | 0.5248 (105% relative improvement) |
CELM generates clinical reports at multiple scales: recording description, background activity, epileptiform abnormalities, events/seizures, and impressions.
Clone the repository:
git clone https://github.com/Jathurshan0330/CELM.git
cd CELM
Set up environment:
conda env create -f setup.yml
conda activate CELM
Our benchmark is built utilizing the dataset from https://bdsp.io/content/harvard-eeg-db/4.1/, which is publicly accessible. Instructions for obtaining access are available on their website. The dataset is large, so we provide the pipeline to download only the necessary files to generate this EEG-Report Benchmark
Run the following script in ./eeg_report_data_construction to construct the EEG-report benchmark efficiently. Make sure to update the data paths and site ID.
./eeg_report_data_construction/prepare_eeg_report_benchmark.sh
Jupyter notebooks in ./eeg_report_data_construction/data_splits can be used to create the data splits for S0001 and S0002.
Run the following scripts using the pretrained weights for the projectors in ./pretrained_CELM_projectors, and infer our CELM. Make sure to download the checkpoints for CBraMod from https://huggingface.co/weighting666/CBraMod and add them to ./eeg_encoders/pretrained_checkpoints.
./CELM_inference.sh
Run the following script to train the Clinical EEG Language Model. Make sure to download the checkpoints for CBraMod from https://huggingface.co/weighting666/CBraMod and add them to ./eeg_encoders/pretrained_checkpoints. The script also enables inference and evaluation on the test set.
./scripts/CELM_training.sh
We also provide the scripts to reproduce the unimodal baselines reported in our manuscript. Simply run the following scripts to reproduce the results. Make sure to set the LLM base model name, which loads from HuggingFace 🤗
For Unimodal + Text only baselines
./scripts/unimodal_text_only_baseline.sh
For Unimodal + Text + EEG Features baselines
./scripts/unimodal_text_and_eeg_features_baseline.sh
If you find this work useful, please consider citing our paper and giving this repo a ⭐!
@article{pradeepkumar2026neural,
title={Neural Signals Generate Clinical Notes in the Wild},
author={Pradeepkumar, Jathurshan and Chen, Zheng and Sun, Jimeng},
journal={arXiv preprint arXiv:2601.22197},
year={2026}
}
We thank the Harvard EEG Database and the CBraMod teams for making their data and models publicly available.
We appreciate your interest in our work! 😃😃😃😃😃