roverx12345/JointAVBench

6

stars

3

commits

Python

primary language

Jun 5, 2026

updated

README

JointAVBench: A Benchmark for Joint Audio-Visual Reasoning Evaluation

Paper Project Page Hugging Face License


๐Ÿ“– Overview

JointAVBench is a comprehensive benchmark for evaluating omni-modal large language models (LLMs) on joint audio-visual reasoning tasks. This repository showcases our benchmark generation pipeline and provides evaluation tools for assessing models on questions that require both visual and auditory information to answer correctly.

โœจ Key Features

  • Large-scale Benchmark: 2,853 questions across 15 diverse task types
  • Automated Generation Pipeline: State-of-the-art vision-LLMs, audio-LLMs, and LLMs automatically synthesize questions requiring joint audio-visual reasoning
  • Multi-dimensional Coverage:
    • 5 cognitive dimensions: Temporal, Spatial, Long-form, Emotional, and Plot understanding
    • 4 audio information types: Speech, Sound events, Music, and Speech emotion
    • 3 scene spans: Single-scene, Multi-scene, and Full-scene reasoning
  • Comprehensive Evaluation: Evaluation suite for majority mainstream omni-modal models
  • Challenging Tasks: Multi-scene tasks requiring complex cross-modal reasoning

๐Ÿ“„ Abstract

Compared to vision or audio large language models (LLMs), the key advantage of omni large language model lies in their joint audio-visual reasoning capability. To train such models, datasets with questions requiring both visual and auditory information to answer are needed. Moreover, videos contain complex audio signal types and scenes, interleaved with each other, demanding models with various cognitive capabilities. However, current datasets lack challenging multi-scene tasks, various types of audio information and cognition abilities.

This paper introduces JointAVBench, a dataset designed to answer questions that necessitate AV integration, spanning 5 cognitive dimensions, 4 audio information types, and 3 scene spans. Our benchmark reveals that the top omni-LLM achieves only 56.2% average accuracy, highlighting significant room for improvement, particularly in cross-scene reasoning.

๐Ÿ“‘ Table of Contents

๐ŸŽฏ Benchmark Overview

๐Ÿ“Š Task Categories

JointAVBench consists of 2,853 questions across 15 distinct tasks spanning multiple dimensions. Details about each task category can be found in the paper.

๐ŸŽจ Example Questions

Example questions from JointAVBench

Sample questions from different task categories showcasing the diversity of our benchmark

๐Ÿง  Cognitive Dimensions

  • Temporal (tem): Understanding time-based relationships and ordering
  • Spatial (spa): Localizing sounds and understanding spatial relationships
  • Long-form (long): Processing and reasoning over extended content
  • Emotional (emo): Recognizing and understanding emotional content
  • Plot (plo): Comprehending narratives and storylines

๐Ÿ”„ Generation Pipeline

Our automated benchmark generation pipeline consists of several stages:

JointAVBench generation framework

Complete pipeline for automated benchmark generation from raw videos

๐Ÿ“ฆ Dataset

โฌ‡๏ธ Download the Benchmark

The JointAVBench dataset is available on Hugging Face:

# Download benchmark questions and videos
pip install huggingface_hub
huggingface-cli download roverx12345/jointavbench --repo-type dataset --local-dir ./data

The benchmark file jointavbench.json contains all 2,853 questions with metadata. The released benchmark clips are provided under videos/ for reproducible evaluation, and each example keeps the original YouTube source in the video_url field. For original high-resolution videos, please refer to the corresponding source links.

๐Ÿ“‚ Dataset Structure

JointAVBench/
โ”œโ”€โ”€ video_annotations.json      # Annotation data
โ”œโ”€โ”€ subtitle.zip                # Video subtitle data
โ”œโ”€โ”€ jointavbench.json           # Evaluation code
โ”œโ”€โ”€ README.md

๐Ÿ“‹ Data Format

Each question in the benchmark follows this format:

{
  "qid": "-CEDoGn0w1s_task1_0",
  "video_name": "-CEDoGn0w1s",
  "task": "STL",
  "question": "Which objects are mentioned only in the dialogue but not clearly shown in the video, and when does the first object appear in the dialogue?",
  "correct_answer": "The broom, mentioned at around 6.34s",
  "explanation": "The object \"broom\" is mentioned in the dialogue but does not appear in the video description. It is the first object mentioned in the dialogue, appearing at around 6.34s.",
  "options": [
    "The shovel, mentioned at around 6.34s",
    "The keys, mentioned at around 3.36s",
    "The hat, mentioned at around 12.76s",
    "The broom, mentioned at around 6.34s"
  ],
  "video_url": "https://www.youtube.com/watch?v=-CEDoGn0w1s",
  "segment_timestamp": [653.444, 699.657]
}

๐Ÿ”ฌ Evaluation

๐Ÿš€ Quick Start

For detailed evaluation instructions, see evaluation/README.md.

# Navigate to evaluation folder
cd evaluation

# Set up environment (see evaluation/README.md)
cp .env.example .env
# Edit .env with your API keys and model paths

# Run evaluation
python evaluation.py --qa-path ../data/benchmark.json --model-name gemini --modality av

๐Ÿค– Supported Models

We provide evaluation scripts for 10+ models:

  • API-based: Gemini, GPT-4o, Kimi-Audio
  • Open-source: LLaVA-Video, InternVL, Qwen-VL/Audio/Omni, Video-LLaMA 2/3, AVicuna

See evaluation/README.md for complete setup and usage instructions.

๐Ÿ“Š Results

Our benchmark reveals significant challenges for current omni-modal models:

  • Top Performance: 56.2% average accuracy
  • Cross-scene Reasoning: Particularly challenging (42-50% accuracy)
  • Single-scene Tasks: Relatively better (68% accuracy)
  • Performance Gaps: Significant variations across cognitive dimensions and audio types
JointAVBench Results

Performance comparison of different models across task categories

๐Ÿ” Key Findings

  1. Multi-modal Reasoning is Hard: Even top models struggle to integrate audio-visual information effectively
  2. Scene Complexity Matters: Performance degrades significantly for multi-scene and full-video tasks
  3. Audio Type Dependency: Models perform differently on speech vs. music vs. sound events
  4. Cognitive Dimension Gaps: Temporal and spatial reasoning show better results than plot understanding

For detailed results and analysis, please refer to our paper.

๐Ÿ“ Project Structure

jointavbench/
โ”œโ”€โ”€ README.md                   # This file (project overview)
โ”œโ”€โ”€ LICENSE                     # Apache 2.0 License
โ”œโ”€โ”€ images/                    # Figures and visualizations
โ”‚   โ”œโ”€โ”€ framework.png         # Pipeline architecture diagram
โ”‚   โ””โ”€โ”€ examples.png          # Example questions showcase
โ”œโ”€โ”€ evaluation/               # Evaluation code and documentation
โ”‚   โ”œโ”€โ”€ README.md            # Complete evaluation guide
โ”‚   โ”œโ”€โ”€ .env.example         # Environment configuration template
โ”‚   โ”œโ”€โ”€ evaluation.py        # Main evaluation script
โ”‚   โ””โ”€โ”€ eval_*.py            # Model-specific evaluation modules
โ”œโ”€โ”€ gen_caption/             # Caption generation module
โ”‚   โ”œโ”€โ”€ README.md           # Caption generation documentation
โ”‚   โ”œโ”€โ”€ audio_caption.py    # Audio caption generation
โ”‚   โ”œโ”€โ”€ video_caption.py    # Video caption generation
โ”‚   โ””โ”€โ”€ utils.py            # Caption utilities
โ””โ”€โ”€ generation_pipeline/    # Benchmark generation pipeline
    โ”œโ”€โ”€ README.md          # Pipeline documentation
    โ”œโ”€โ”€ identify_intervals.py   # Interval identification
    โ”œโ”€โ”€ generate_qa.py          # QA generation
    โ”œโ”€โ”€ generate_distractor.py # Distractor generation
    โ”œโ”€โ”€ *_check.py             # Quality control scripts
    โ””โ”€โ”€ utils.py               # Pipeline utilities

๐Ÿ“ Citation

If you find JointAVBench useful for your research, please cite our paper:

@article{chao2025jointavbench,
  title={JointAVBench: A Benchmark for Joint Audio-Visual Reasoning Evaluation},
  author={Chao, Jianghan and Gao, Jianzhang and Tan, Wenhui and Sun, Yuchong and Song, Ruihua and Ru, Liyun},
  journal={arXiv preprint arXiv:2512.12772},
  year={2025}
}

๐Ÿ“ฎ Contact

For questions and feedback:

Contributors

roverx12345

3 commits

roverx12345/JointAVBench

6

stars

3

commits

Python

primary language

Jun 5, 2026

updated

README

JointAVBench: A Benchmark for Joint Audio-Visual Reasoning Evaluation

Paper Project Page Hugging Face License


๐Ÿ“– Overview

JointAVBench is a comprehensive benchmark for evaluating omni-modal large language models (LLMs) on joint audio-visual reasoning tasks. This repository showcases our benchmark generation pipeline and provides evaluation tools for assessing models on questions that require both visual and auditory information to answer correctly.

โœจ Key Features

  • Large-scale Benchmark: 2,853 questions across 15 diverse task types
  • Automated Generation Pipeline: State-of-the-art vision-LLMs, audio-LLMs, and LLMs automatically synthesize questions requiring joint audio-visual reasoning
  • Multi-dimensional Coverage:
    • 5 cognitive dimensions: Temporal, Spatial, Long-form, Emotional, and Plot understanding
    • 4 audio information types: Speech, Sound events, Music, and Speech emotion
    • 3 scene spans: Single-scene, Multi-scene, and Full-scene reasoning
  • Comprehensive Evaluation: Evaluation suite for majority mainstream omni-modal models
  • Challenging Tasks: Multi-scene tasks requiring complex cross-modal reasoning

๐Ÿ“„ Abstract

Compared to vision or audio large language models (LLMs), the key advantage of omni large language model lies in their joint audio-visual reasoning capability. To train such models, datasets with questions requiring both visual and auditory information to answer are needed. Moreover, videos contain complex audio signal types and scenes, interleaved with each other, demanding models with various cognitive capabilities. However, current datasets lack challenging multi-scene tasks, various types of audio information and cognition abilities.

This paper introduces JointAVBench, a dataset designed to answer questions that necessitate AV integration, spanning 5 cognitive dimensions, 4 audio information types, and 3 scene spans. Our benchmark reveals that the top omni-LLM achieves only 56.2% average accuracy, highlighting significant room for improvement, particularly in cross-scene reasoning.

๐Ÿ“‘ Table of Contents

๐ŸŽฏ Benchmark Overview

๐Ÿ“Š Task Categories

JointAVBench consists of 2,853 questions across 15 distinct tasks spanning multiple dimensions. Details about each task category can be found in the paper.

๐ŸŽจ Example Questions

Example questions from JointAVBench

Sample questions from different task categories showcasing the diversity of our benchmark

๐Ÿง  Cognitive Dimensions

  • Temporal (tem): Understanding time-based relationships and ordering
  • Spatial (spa): Localizing sounds and understanding spatial relationships
  • Long-form (long): Processing and reasoning over extended content
  • Emotional (emo): Recognizing and understanding emotional content
  • Plot (plo): Comprehending narratives and storylines

๐Ÿ”„ Generation Pipeline

Our automated benchmark generation pipeline consists of several stages:

JointAVBench generation framework

Complete pipeline for automated benchmark generation from raw videos

๐Ÿ“ฆ Dataset

โฌ‡๏ธ Download the Benchmark

The JointAVBench dataset is available on Hugging Face:

# Download benchmark questions and videos
pip install huggingface_hub
huggingface-cli download roverx12345/jointavbench --repo-type dataset --local-dir ./data

The benchmark file jointavbench.json contains all 2,853 questions with metadata. The released benchmark clips are provided under videos/ for reproducible evaluation, and each example keeps the original YouTube source in the video_url field. For original high-resolution videos, please refer to the corresponding source links.

๐Ÿ“‚ Dataset Structure

JointAVBench/
โ”œโ”€โ”€ video_annotations.json      # Annotation data
โ”œโ”€โ”€ subtitle.zip                # Video subtitle data
โ”œโ”€โ”€ jointavbench.json           # Evaluation code
โ”œโ”€โ”€ README.md

๐Ÿ“‹ Data Format

Each question in the benchmark follows this format:

{
  "qid": "-CEDoGn0w1s_task1_0",
  "video_name": "-CEDoGn0w1s",
  "task": "STL",
  "question": "Which objects are mentioned only in the dialogue but not clearly shown in the video, and when does the first object appear in the dialogue?",
  "correct_answer": "The broom, mentioned at around 6.34s",
  "explanation": "The object \"broom\" is mentioned in the dialogue but does not appear in the video description. It is the first object mentioned in the dialogue, appearing at around 6.34s.",
  "options": [
    "The shovel, mentioned at around 6.34s",
    "The keys, mentioned at around 3.36s",
    "The hat, mentioned at around 12.76s",
    "The broom, mentioned at around 6.34s"
  ],
  "video_url": "https://www.youtube.com/watch?v=-CEDoGn0w1s",
  "segment_timestamp": [653.444, 699.657]
}

๐Ÿ”ฌ Evaluation

๐Ÿš€ Quick Start

For detailed evaluation instructions, see evaluation/README.md.

# Navigate to evaluation folder
cd evaluation

# Set up environment (see evaluation/README.md)
cp .env.example .env
# Edit .env with your API keys and model paths

# Run evaluation
python evaluation.py --qa-path ../data/benchmark.json --model-name gemini --modality av

๐Ÿค– Supported Models

We provide evaluation scripts for 10+ models:

  • API-based: Gemini, GPT-4o, Kimi-Audio
  • Open-source: LLaVA-Video, InternVL, Qwen-VL/Audio/Omni, Video-LLaMA 2/3, AVicuna

See evaluation/README.md for complete setup and usage instructions.

๐Ÿ“Š Results

Our benchmark reveals significant challenges for current omni-modal models:

  • Top Performance: 56.2% average accuracy
  • Cross-scene Reasoning: Particularly challenging (42-50% accuracy)
  • Single-scene Tasks: Relatively better (68% accuracy)
  • Performance Gaps: Significant variations across cognitive dimensions and audio types
JointAVBench Results

Performance comparison of different models across task categories

๐Ÿ” Key Findings

  1. Multi-modal Reasoning is Hard: Even top models struggle to integrate audio-visual information effectively
  2. Scene Complexity Matters: Performance degrades significantly for multi-scene and full-video tasks
  3. Audio Type Dependency: Models perform differently on speech vs. music vs. sound events
  4. Cognitive Dimension Gaps: Temporal and spatial reasoning show better results than plot understanding

For detailed results and analysis, please refer to our paper.

๐Ÿ“ Project Structure

jointavbench/
โ”œโ”€โ”€ README.md                   # This file (project overview)
โ”œโ”€โ”€ LICENSE                     # Apache 2.0 License
โ”œโ”€โ”€ images/                    # Figures and visualizations
โ”‚   โ”œโ”€โ”€ framework.png         # Pipeline architecture diagram
โ”‚   โ””โ”€โ”€ examples.png          # Example questions showcase
โ”œโ”€โ”€ evaluation/               # Evaluation code and documentation
โ”‚   โ”œโ”€โ”€ README.md            # Complete evaluation guide
โ”‚   โ”œโ”€โ”€ .env.example         # Environment configuration template
โ”‚   โ”œโ”€โ”€ evaluation.py        # Main evaluation script
โ”‚   โ””โ”€โ”€ eval_*.py            # Model-specific evaluation modules
โ”œโ”€โ”€ gen_caption/             # Caption generation module
โ”‚   โ”œโ”€โ”€ README.md           # Caption generation documentation
โ”‚   โ”œโ”€โ”€ audio_caption.py    # Audio caption generation
โ”‚   โ”œโ”€โ”€ video_caption.py    # Video caption generation
โ”‚   โ””โ”€โ”€ utils.py            # Caption utilities
โ””โ”€โ”€ generation_pipeline/    # Benchmark generation pipeline
    โ”œโ”€โ”€ README.md          # Pipeline documentation
    โ”œโ”€โ”€ identify_intervals.py   # Interval identification
    โ”œโ”€โ”€ generate_qa.py          # QA generation
    โ”œโ”€โ”€ generate_distractor.py # Distractor generation
    โ”œโ”€โ”€ *_check.py             # Quality control scripts
    โ””โ”€โ”€ utils.py               # Pipeline utilities

๐Ÿ“ Citation

If you find JointAVBench useful for your research, please cite our paper:

@article{chao2025jointavbench,
  title={JointAVBench: A Benchmark for Joint Audio-Visual Reasoning Evaluation},
  author={Chao, Jianghan and Gao, Jianzhang and Tan, Wenhui and Sun, Yuchong and Song, Ruihua and Ru, Liyun},
  journal={arXiv preprint arXiv:2512.12772},
  year={2025}
}

๐Ÿ“ฎ Contact

For questions and feedback:

Contributors

roverx12345

3 commits

Languages

Python

100.0%