Taiying Peng1, Jiacheng Hua2, Miao Liu2†, Feng Lu1†
1State Key Laboratory of VR Technology and Systems, School of CSE, Beihang University
2College of AI, Tsinghua University
NeurIPS D&B 2025
This repository provides the official code for EgoGazeVQA, a benchmark for evaluating multimodal large language models (MLLMs) on egocentric video understanding tasks with gaze guidance.
Code Purpose:
- Generate gaze-guided QA pairs from egocentric videos (spatial, temporal, causal intent questions)
- Evaluate MLLMs with three gaze-guided prompting strategies (textual, visual marks, salience maps)
- Calculate and analyze model performance on intent understanding tasks
- [2025-10] Code and dataset publicly released
- [2025-09] Paper accepted at NeurIPS 2025 D&B Track
- Add fine-tuning scripts for LoRA adaptation
EgoGazeVQA/
├── generate_tool/
│ ├── auto.sh
│ ├── spatial.py
│ ├── temporal.py
│ ├── causal.py
│ └── create_datasets.py
├── test_tool/
│ ├── qwenvl_test/
│ │ ├── test_wo.py
│ │ ├── test_gaze.py
│ │ ├── test_mark.py
│ │ └── test_saliencemap.py
│ ├── prompt_gazees/
│ ├── multiframes/
│ ├── gaze_trajectory.py
│ └── caculate.py
git clone https://github.com/taiyi98/EgoGazeVQA.git
cd EgoGazeVQA
conda create -n egogazevqa python=3.10
conda activate egogazevqa
pip install -r requirements.txtDownload from 🤗 Hugging Face:
huggingface-cli download taiyi98/EgoGazeVQA --repo-type dataset --local-dir ./datacd generate_tool
# Generate for specific video
python spatial.py --video_id <VIDEO_ID> --target_index <INDEX>
python temporal.py --video_id <VIDEO_ID> --target_index <INDEX>
python causal.py --video_id <VIDEO_ID> --target_index <INDEX>
# Batch processing
bash auto.shcd test_tool/qwenvl_test
python test_wo.py # Baseline (no gaze)
python test_gaze.py # Textual gaze prompt
python test_mark.py # Visual gaze marks
python test_saliencemap.py # Gaze salience mapscd test_tool
python caculate.py --result_file <RESULT_CSV_PATH>@misc{peng2025eyemllmbenchmarkingegocentric,
title={In the Eye of MLLM: Benchmarking Egocentric Video Intent Understanding with Gaze-Guided Prompting},
author={Taiying Peng and Jiacheng Hua and Miao Liu and Feng Lu},
year={2025},
eprint={2509.07447},
archivePrefix={arXiv},
primaryClass={cs.CV},
url={https://arxiv.org/abs/2509.07447}
}This project is licensed under the MIT License - see the LICENSE file for details.
