MCPcopy Index your code
hub / github.com/FunAudioLLM/MME-Emotion

github.com/FunAudioLLM/MME-Emotion @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
116 symbols 421 edges 25 files 16 documented · 14%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

MME-Emotion: A Holistic Evaluation Benchmark for Emotional Intelligence in Multimodal Large Language Models

Video QA Emotion Reasoning Emotion Recognition
MME-Emotion GPT-4 Gemini Qwen-VL

<img src="https://github.com/FunAudioLLM/MME-Emotion/raw/main/figs/logo.png" width="100%" height="100%">

[🍎 Project Page] [📖 arXiv Paper] [📊 Dataset] [🏆 Leaderboard]

🌟 Official repository for the paper "MME-Emotion: A Holistic Evaluation Benchmark for Emotional Intelligence in Multimodal Large Language Models"


💥 News

👀 About MME-Emotion

Recent advances in multimodal large language models (MLLMs) have catalyzed transformative progress in affective computing, enabling models to exhibit emergent emotional intelligence. Despite substantial methodological progress, current emotional benchmarks remain limited, as it is still unknown: (a) the generalization abilities of MLLMs across distinct scenarios, and (b) their reasoning capabilities to identify the triggering factors behind emotional states. To bridge these gaps, we present MME-Emotion, a systematic benchmark that assesses both emotional understanding and reasoning capabilities of MLLMs, enjoying scalable capacity, diverse settings, and unified protocols. As the largest emotional intelligence benchmark for MLLMs, MME-Emotion contains 6,500 curated video clips with task-specific questioning-answering pairs, spanning broad scenarios to formulate 8 emotional tasks.

<img src="https://github.com/FunAudioLLM/MME-Emotion/raw/main/figs/intro.png" width="100%">

MME-Emotion further incorporates a holistic evaluation suite with three metrics (recognition score, reasoning score, and CoT score) for emotion recognition and reasoning, analyzed through a multi-agent system framework. The validity of our evaluation strategy is also fully verified by five human experts.

<img src="https://github.com/FunAudioLLM/MME-Emotion/raw/main/figs/eval.png" width="100%">

In addition, we systematically evaluate the performance of 20 open-source an closed-source cutting-edge MLLMs on MME-Emotion.

🚀 Evaluation

After obtaining the answer from a specific MLLM and pre-extracted audio clues, we can subsequently extract key steps and evaluate the performance.

Extracting Key Steps:

python ./extract_step/task/code/extract_step.py \
    --input_json "$ MLLM resposne file" \
    --output_json "$ saved step file" 

Evaluating Performance:

python ./eval_cot/task/code/eval_cot_gpt4o.py \
    --video_dir "$ video directory" \
    --audio_json "$ aduio clues file" \
    --response_json "$ saved step file" \
    --output_json "$ saved eval file" 

💪 Calculating Metrics

After getting GPT-4o's evaluation, we can calculate the metrics.

Calculating Metrics:

python ./eval_cot/task/metrics/cal_metrics.py \
    --input_json "$ saved eval file" \
    --output_txt "$ saved metrics file" \
    --model_name "$ evaluated MLLM" 

🏆 Leaderboard

  • Overall Performance Comparison:

  • Task-level Performance Comparison:

:white_check_mark: Citation

If you find MME-Emotion useful for your research and applications, please kindly cite using this BibTeX:

@article{zhang2025mme,
  title={MME-Emotion: A Holistic Evaluation Benchmark for Emotional Intelligence in Multimodal Large Language Models},
  author={Zhang, Fan and Cheng, Zebang and Deng, Chong and Li, Haoxuan and Lian, Zheng and Chen, Qian and Liu, Huadai and Wang, Wen and Zhang, Yi-Fan and Zhang, Renrui and others},
  journal={arXiv preprint arXiv:2508.09210},
  year={2025}
}

🔥 Please contact fzhang@link.cuhk.edu.hk if you would like to contribute to the leaderboard or have any problems.

Core symbols most depended-on inside this repo

parse_score
called by 1
eval_cot/ML-ER/metrics/cal_metrics.py
calculate_metrics
called by 1
eval_cot/ML-ER/metrics/cal_metrics.py
process_data
called by 1
eval_cot/ML-ER/metrics/cal_metrics.py
save_results
called by 1
eval_cot/ML-ER/metrics/cal_metrics.py
extract_key_frames
called by 1
eval_cot/ML-ER/code/eval_cot_gpt4o.py
analyze_video
called by 1
eval_cot/ML-ER/code/eval_cot_gpt4o.py
process_dataset
called by 1
eval_cot/ML-ER/code/eval_cot_gpt4o.py
main
called by 1
eval_cot/ML-ER/code/eval_cot_gpt4o.py

Shape

Function 60
Method 40
Class 16

Languages

Python100%

Modules by API surface

eval_cot/SA/code/eval_cot_gpt4o.py8 symbols
eval_cot/Noise-ER/code/eval_cot_gpt4o.py8 symbols
eval_cot/ML-ER/code/eval_cot_gpt4o.py8 symbols
eval_cot/IR/code/eval_cot_gpt4o.py8 symbols
eval_cot/FG-SA/code/eval_cot_gpt4o.py8 symbols
eval_cot/FG-ER/code/eval_cot_gpt4o.py8 symbols
eval_cot/ER-Wild/code/eval_cot_gpt4o.py8 symbols
eval_cot/ER-Lab/code/eval_cot_gpt4o.py8 symbols
eval_cot/SA/metrics/cal_metrics.py4 symbols
eval_cot/Overall/metrics/cal_metrics.py4 symbols
eval_cot/Noise-ER/metrics/cal_metrics.py4 symbols
eval_cot/ML-ER/metrics/cal_metrics.py4 symbols

For agents

$ claude mcp add MME-Emotion \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact