FriendsQA: A New Large-Scale Deep Video Understanding Dataset with Fine-grained Topic Categorization for Story Videos

FriendsQA datasets

• single-episode questions path: FriendsQA/friendsqa_single.json
• cross-episode questions path: FriendsQA/friendsqa_cross.json
• Videos of $\textit{Friends}$ sitcoms can be found in Link or other websites. For the name of video, S means season, E means episode (e.g., S01E01 means season 1 episode 1).

StoryMind Framework

Quick Start

• Environment

  pip install -r requirements.txt

• Download shot-based instance search result of Friends from ZQFive/shot_ins · Hugging Face

  cd utils
  git clone https://huggingface.co/ZQFive/shot_ins

• Generator （Use sh sh/generator.sh to run）

  ### generator.sh
  python generator.py --google_api_key "Replace with your gemini api key" --num_workers 1  --worker 0  --begin 0  --end 250 

• Reviewer（Use sh sh/reviewer.sh to run）

  ### reviewer.sh
  python reviewer.py --gemini_model gemini-1.5-pro-latest \
                     --google_api_key "Replace with your gemini api key" \
                     --claude_model claude-3-5-sonnet-20240620 \
                     --claude_api_key "Replace with your claude api key" \
                     --claude_proxy "Replace with your claude proxy"

• Filter process

  python filter.py

And you will find questions in directory json/， default it will generate json/single_episode_questions.json

About the StoryMind Framework

We are continuously optimizing and expanding our StoryMind framework to better adapt and apply it to various types of story videos. In the future, we plan to enhance the framework's flexibility and expressiveness by introducing new algorithms and technologies, ultimately providing users with a richer and more diverse creative experience.

We welcome community feedback and suggestions, and we look forward to exploring the many possibilities of StoryMind together.

Citation

If you find this repository useful, please consider giving ⭐ or citing:

@article{Wu_Li_Xu_Wang_Xiao_Liang_2025, 
    title={FriendsQA: A New Large-Scale Deep Video Understanding Dataset with Fine-grained Topic Categorization for Story Videos}, 
    volume={39}, 
    url={https://ojs.aaai.org/index.php/AAAI/article/view/32920}, 
    DOI={10.1609/aaai.v39i8.32920}, 
    number={8}, 
    journal={Proceedings of the AAAI Conference on Artificial Intelligence}, 
    author={Wu, Zhengqian and Li, Ruizhe and Xu, Zijun and Wang, Zhongyuan and Xiao, Chunxia and Liang, Chao}, 
    year={2025}, 
    month={Apr.}, 
    pages={8523-8531} 
}