Skip to content

Repository files navigation

In the Eye of MLLM: Benchmarking Egocentric Video Intent Understanding with Gaze-Guided Prompting

Paper Project Page Dataset

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


Overview

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

EgoGazeVQA Overview

Timeline

  • [2025-10] Code and dataset publicly released
  • [2025-09] Paper accepted at NeurIPS 2025 D&B Track

TODO

  • Add fine-tuning scripts for LoRA adaptation

Repository Structure

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

Installation

git clone https://github.com/taiyi98/EgoGazeVQA.git
cd EgoGazeVQA

conda create -n egogazevqa python=3.10
conda activate egogazevqa

pip install -r requirements.txt

Dataset

Download from 🤗 Hugging Face:

huggingface-cli download taiyi98/EgoGazeVQA --repo-type dataset --local-dir ./data

Usage

Generate QA Pairs

cd 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.sh

Evaluate Models

cd 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 maps

Calculate Results

cd test_tool
python caculate.py --result_file <RESULT_CSV_PATH>

Citation

@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}
}

License

This project is licensed under the MIT License - see the LICENSE file for details.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages