Anisha Saha, Varsha Suresh, Timothy Hospedales, Vera Demberg
🔗 Project Page 📄 Paper
MUStReason provides reasoning-aligned annotations that enable detailed evaluation of modality perception and inference failure which are key factors for assessing and improving pragmatic reasoning in multimodal models. In addition, the paper introduces PragCoT, a pragmatic reasoning framework for developing complex reasoning abilities in Video-LMs, through the integration of information from multiple modalities and the systematic resolution of sub-problems.
The folder mustreason/ contains the annotated reasoning comprising the MUStReason dataset.
This repository contains experiment scripts for the MUStReason paper workflows.
inputs/: required CSV inputs.methods/: main prompting strategies.ablations/: LLM and decoding ablations.You need:
inputs/sarcasm_explanation_70B.csvinputs/mustard-sarcasm-labelled.csvutterance_videos/ folder (video files, e.g. *.mp4) at the root of this project folder.For the video file requirements, download the MUStARD++ Balanced dataset from here
environment.yml or requirements.txt.File: methods/zero_shot_wo_reasoning.py
Meaning:
Run:
python methods/zero_shot_wo_reasoning.py
File: methods/zero_shot_w_reasoning.py
Meaning:
Run:
python methods/zero_shot_w_reasoning.py
File: methods/few_shot.py
Meaning:
Run:
python methods/few_shot.py
File: methods/mmcot.py
Meaning:
sharegpt, video-llava, videogpt, vita, prompt-2 and prompt-4 are omitted as they cannot process audio. Text utterances are provided explicitly to these models.Run:
python methods/mmcot.py
File: methods/pragcot.py
Meaning:
sharegpt, video-llava, videogpt, vita, prompt-2 and prompt-4 are omitted as they cannot process audio. Text utterances are provided explicitly to these models.Run:
python methods/pragcot.py
Inside each method file, edit:
RUN_MODELS = ["all"] to run all supported models, orRUN_MODELS = ["qwenomni"] (example) to run one model.Outputs are written under outputs/<method_name>/<model_name>/.
File: ablations/ablation_wo_face_decoding.py
Meaning:
response_4 contribution from final reasoning prompt.Run:
python ablations/ablation_wo_face_decoding.py
File: ablations/ablation_wo_intent_decoding.py
Meaning:
response_6 contribution from final reasoning prompt.Run:
python ablations/ablation_wo_intent_decoding.py
File: ablations/llm_ablation.py
Meaning:
sarcasm_explanation_70B.csv) and runs text-only LLM inference across:
Run:
python ablations/llm_ablation.py
For questions, feel free to contact:
Anisha Saha
📧 ansaha@mpi-inf.mpg.de
🔗 anisha0325.github.io
If you use this work in your research, please cite:
@misc{saha2025mustreasonbenchmarkdiagnosingpragmatic,
title={MUStReason: A Benchmark for Diagnosing Pragmatic Reasoning in Video-LMs for Multimodal Sarcasm Detection},
author={Anisha Saha and Varsha Suresh and Timothy Hospedales and Vera Demberg},
year={2025},
eprint={2510.23727},
archivePrefix={arXiv},
primaryClass={cs.LG},
url={https://arxiv.org/abs/2510.23727},
}
43 commits
Python
100.0%
Anisha Saha, Varsha Suresh, Timothy Hospedales, Vera Demberg
🔗 Project Page 📄 Paper
MUStReason provides reasoning-aligned annotations that enable detailed evaluation of modality perception and inference failure which are key factors for assessing and improving pragmatic reasoning in multimodal models. In addition, the paper introduces PragCoT, a pragmatic reasoning framework for developing complex reasoning abilities in Video-LMs, through the integration of information from multiple modalities and the systematic resolution of sub-problems.
The folder mustreason/ contains the annotated reasoning comprising the MUStReason dataset.
This repository contains experiment scripts for the MUStReason paper workflows.
inputs/: required CSV inputs.methods/: main prompting strategies.ablations/: LLM and decoding ablations.You need:
inputs/sarcasm_explanation_70B.csvinputs/mustard-sarcasm-labelled.csvutterance_videos/ folder (video files, e.g. *.mp4) at the root of this project folder.For the video file requirements, download the MUStARD++ Balanced dataset from here
environment.yml or requirements.txt.File: methods/zero_shot_wo_reasoning.py
Meaning:
Run:
python methods/zero_shot_wo_reasoning.py
File: methods/zero_shot_w_reasoning.py
Meaning:
Run:
python methods/zero_shot_w_reasoning.py
File: methods/few_shot.py
Meaning:
Run:
python methods/few_shot.py
File: methods/mmcot.py
Meaning:
sharegpt, video-llava, videogpt, vita, prompt-2 and prompt-4 are omitted as they cannot process audio. Text utterances are provided explicitly to these models.Run:
python methods/mmcot.py
File: methods/pragcot.py
Meaning:
sharegpt, video-llava, videogpt, vita, prompt-2 and prompt-4 are omitted as they cannot process audio. Text utterances are provided explicitly to these models.Run:
python methods/pragcot.py
Inside each method file, edit:
RUN_MODELS = ["all"] to run all supported models, orRUN_MODELS = ["qwenomni"] (example) to run one model.Outputs are written under outputs/<method_name>/<model_name>/.
File: ablations/ablation_wo_face_decoding.py
Meaning:
response_4 contribution from final reasoning prompt.Run:
python ablations/ablation_wo_face_decoding.py
File: ablations/ablation_wo_intent_decoding.py
Meaning:
response_6 contribution from final reasoning prompt.Run:
python ablations/ablation_wo_intent_decoding.py
File: ablations/llm_ablation.py
Meaning:
sarcasm_explanation_70B.csv) and runs text-only LLM inference across:
Run:
python ablations/llm_ablation.py
For questions, feel free to contact:
Anisha Saha
📧 ansaha@mpi-inf.mpg.de
🔗 anisha0325.github.io
If you use this work in your research, please cite:
@misc{saha2025mustreasonbenchmarkdiagnosingpragmatic,
title={MUStReason: A Benchmark for Diagnosing Pragmatic Reasoning in Video-LMs for Multimodal Sarcasm Detection},
author={Anisha Saha and Varsha Suresh and Timothy Hospedales and Vera Demberg},
year={2025},
eprint={2510.23727},
archivePrefix={arXiv},
primaryClass={cs.LG},
url={https://arxiv.org/abs/2510.23727},
}
43 commits
Python
100.0%