sejong-rcv/Video-Oasis

[ECCV 2026] Video-Oasis: Rethinking Evaluation of Video Understanding

Python

38

41 commits

updated Oct 19, 2026

See the code

README

Video-Oasis: Rethinking Evaluation of Video Understanding

Project Page arXiv GitHub Hugging Face Paper

TL;DR. Video-Oasis rethinks the current benchmark landscape by examining whether proliferating video benchmarks truly satisfy shared criteria for genuine video understanding.

News

πŸ”₯ Getting Started

πŸ”¨ Installation

  • Requirements: Python β‰₯ 3.12, CUDA-compatible GPUs, torch, vllm >= 0.11.0, transformers >= 4.57.0.

🎞 Dataset & Models

Dataset

  • We begin by curating 14 diverse benchmarks, covering tasks from perception to reasoning across durations spanning seconds to hours.

  • The full list of benchmarks is available here.

    • Run python download_videos.py within each directory to download the data.
  • After downloading all benchmarks, run python run_ffmpeg.py to process and fix any corrupted or unreadable videos.

  • Once completed, your directory structure should look like this:

β”œβ”€β”€ data/benchmarks/videos
   β”œβ”€β”€ egoschema
      └── videos
         β”œβ”€β”€ video_1
         β”œβ”€β”€ video_2
         └── ...

   β”œβ”€β”€ implicitqa
      └── videos
         β”œβ”€β”€ video_1
         β”œβ”€β”€ video_2
         └── ...

   β”œβ”€β”€ ...
 
   β”œβ”€β”€ vsi-bench
      └── videos
         β”œβ”€β”€ video_1
         β”œβ”€β”€ video_2
         └── ...

Model

  • For model checkpoint, move to the data/models directory and run python download_models.py to download your desired models.

  • By default, we support models that can be downloaded via huggingface_hub's snapshot_download.

  • For custom models, please download them manually and place them in the appropriate directory.

πŸ“‘ Evaluation

  • Evaluation is handled via lmms-eval, which is bundled within this repository.

  • The scripts to run the benchmark suite used in our paper are located in the src/scripts directory.

  • To execute the evaluation, simply set the task argument to either vqa_total or v_oasis in the script.

  • An example execution script is provided below:

model_path=Video-Oasis/data/models/models/Eagle2.5-8B
output_path=./experiments/Eagle2.5-8B_16K/
master_port=$(python -c 'import socket; s=socket.socket(); s.bind(("", 0)); print(s.getsockname()[1]); s.close()')

task=vqa_total # or v_oasis

accelerate launch --num_processes=8 --main_process_port=$master_port -m lmms_eval.__main__ \
    --model eagle2_5 \
    --model_args pretrained=$model_path, \
    --tasks "$task" \
    --batch_size 1 \
    --log_samples \
    --output_path "${output_path}/"

Video-Oasis

The Video-Oasis diagnostic suite is available in src/criteria. It includes the Visual Dependency, Temporal Dependency, and Ambiguity tests used to construct Video-Oasis. See the diagnostic suite guide for the code structure and execution workflow.


Acknowledgements πŸ‘

Citation πŸŽ“

If you find this work useful, please cite our paper:

@inproceedings{lim2026videooasis,
  title={Video-Oasis: Rethinking Evaluation of Video Understanding},
  author={Geuntaek Lim and Sungjune Park and Jaeyun Lee and Inwoong Lee and Taeoh Kim and Dongyoon Wee and Minho Shim and Yukyung Choi},
  booktitle={European Conference on Computer Vision (ECCV)},
  year={2026}
}

License πŸ“„

This project is licensed under the MIT License β€” see the LICENSE file for details.

sejong-rcv/Video-Oasis

[ECCV 2026] Video-Oasis: Rethinking Evaluation of Video Understanding

Python

38

41 commits

updated Oct 19, 2026

See the code

README

Video-Oasis: Rethinking Evaluation of Video Understanding

Project Page arXiv GitHub Hugging Face Paper

TL;DR. Video-Oasis rethinks the current benchmark landscape by examining whether proliferating video benchmarks truly satisfy shared criteria for genuine video understanding.

News

πŸ”₯ Getting Started

πŸ”¨ Installation

  • Requirements: Python β‰₯ 3.12, CUDA-compatible GPUs, torch, vllm >= 0.11.0, transformers >= 4.57.0.

🎞 Dataset & Models

Dataset

  • We begin by curating 14 diverse benchmarks, covering tasks from perception to reasoning across durations spanning seconds to hours.

  • The full list of benchmarks is available here.

    • Run python download_videos.py within each directory to download the data.
  • After downloading all benchmarks, run python run_ffmpeg.py to process and fix any corrupted or unreadable videos.

  • Once completed, your directory structure should look like this:

β”œβ”€β”€ data/benchmarks/videos
   β”œβ”€β”€ egoschema
      └── videos
         β”œβ”€β”€ video_1
         β”œβ”€β”€ video_2
         └── ...

   β”œβ”€β”€ implicitqa
      └── videos
         β”œβ”€β”€ video_1
         β”œβ”€β”€ video_2
         └── ...

   β”œβ”€β”€ ...
 
   β”œβ”€β”€ vsi-bench
      └── videos
         β”œβ”€β”€ video_1
         β”œβ”€β”€ video_2
         └── ...

Model

  • For model checkpoint, move to the data/models directory and run python download_models.py to download your desired models.

  • By default, we support models that can be downloaded via huggingface_hub's snapshot_download.

  • For custom models, please download them manually and place them in the appropriate directory.

πŸ“‘ Evaluation

  • Evaluation is handled via lmms-eval, which is bundled within this repository.

  • The scripts to run the benchmark suite used in our paper are located in the src/scripts directory.

  • To execute the evaluation, simply set the task argument to either vqa_total or v_oasis in the script.

  • An example execution script is provided below:

model_path=Video-Oasis/data/models/models/Eagle2.5-8B
output_path=./experiments/Eagle2.5-8B_16K/
master_port=$(python -c 'import socket; s=socket.socket(); s.bind(("", 0)); print(s.getsockname()[1]); s.close()')

task=vqa_total # or v_oasis

accelerate launch --num_processes=8 --main_process_port=$master_port -m lmms_eval.__main__ \
    --model eagle2_5 \
    --model_args pretrained=$model_path, \
    --tasks "$task" \
    --batch_size 1 \
    --log_samples \
    --output_path "${output_path}/"

Video-Oasis

The Video-Oasis diagnostic suite is available in src/criteria. It includes the Visual Dependency, Temporal Dependency, and Ambiguity tests used to construct Video-Oasis. See the diagnostic suite guide for the code structure and execution workflow.


Acknowledgements πŸ‘

Citation πŸŽ“

If you find this work useful, please cite our paper:

@inproceedings{lim2026videooasis,
  title={Video-Oasis: Rethinking Evaluation of Video Understanding},
  author={Geuntaek Lim and Sungjune Park and Jaeyun Lee and Inwoong Lee and Taeoh Kim and Dongyoon Wee and Minho Shim and Yukyung Choi},
  booktitle={European Conference on Computer Vision (ECCV)},
  year={2026}
}

License πŸ“„

This project is licensed under the MIT License β€” see the LICENSE file for details.