Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mbzuai-oryx/videogpt-plus
Official Repository of paper VideoGPT+: Integrating Image and Video Encoders for Enhanced Video Understanding
https://github.com/mbzuai-oryx/videogpt-plus
chatbot clip dual-encoder gpt4 gpt4o image-encoder llama3 llava multimodal phi-3-mini vicuna video-chatbot video-conversation video-encoder vision-language vision-language-pretraining
Last synced: 2 days ago
JSON representation
Official Repository of paper VideoGPT+: Integrating Image and Video Encoders for Enhanced Video Understanding
- Host: GitHub
- URL: https://github.com/mbzuai-oryx/videogpt-plus
- Owner: mbzuai-oryx
- License: cc-by-4.0
- Created: 2024-06-13T17:27:16.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-08-11T16:24:43.000Z (about 2 months ago)
- Last Synced: 2024-09-23T11:04:51.883Z (3 days ago)
- Topics: chatbot, clip, dual-encoder, gpt4, gpt4o, image-encoder, llama3, llava, multimodal, phi-3-mini, vicuna, video-chatbot, video-conversation, video-encoder, vision-language, vision-language-pretraining
- Language: Python
- Homepage:
- Size: 16.5 MB
- Stars: 191
- Watchers: 5
- Forks: 15
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# VideoGPT+ :movie_camera: :speech_balloon:
### VideoGPT+: Integrating Image and Video Encoders for Enhanced Video Understanding
#### [Muhammad Maaz](https://www.muhammadmaaz.com) , [Hanoona Rasheed](https://www.hanoonarasheed.com/) , [Salman Khan](https://salman-h-khan.github.io/) and [Fahad Khan](https://sites.google.com/view/fahadkhans/home)
#### **Mohamed bin Zayed University of Artificial Intelligence**
---
[](https://arxiv.org/abs/2406.09418)
[](https://huggingface.co/collections/MBZUAI/videogpt-665c8643221dda4987a67d8d)
[](https://huggingface.co/datasets/MBZUAI/VCGBench-Diverse)
[](https://huggingface.co/datasets/MBZUAI/video_annotation_pipeline)
---
**Diverse Video-based Generative Performance Benchmarking (VCGBench-Diverse)**
[](https://paperswithcode.com/sota/vcgbench-diverse-on-videoinstruct?p=videogpt-integrating-image-and-video-encoders)
**Video Question Answering on MVBench**
[](https://paperswithcode.com/sota/video-question-answering-on-mvbench?p=videogpt-integrating-image-and-video-encoders)
**Video-based Generative Performance Benchmarking**
[](https://paperswithcode.com/sota/video-based-generative-performance?p=videogpt-integrating-image-and-video-encoders)
---
## :loudspeaker: Latest Updates
- **Jun-13-24**: VideoGPT+ paper, code, model, dataset and benchmark is released. :fire::fire:
---
## VideoGPT+ Overview :bulb:
VideoGPT+ integrates image and video encoders to leverage detailed spatial understanding and global temporal context, respectively. It processes videos in segments using adaptive pooling on features from both encoders, enhancing performance across various video benchmarks.
---
## Contributions :trophy:
- **VideoGPT+ Model**: We present VideoGPT+, the first video-conversation model that benefits from a dual-encoding scheme based on both image and video features. These complimentary sets of features offer rich spatiotemporal details for improved video understanding.
- **VCG+ 112K Dataset**: Addressing the limitations of the existing VideoInstruct100K dataset, we develop VCG+ 112K with a novel semi-automatic annotation pipeline, offering dense video captions along with spatial understanding and reasoning-based QA pairs, further improving the model performance.
- **VCGBench-Diverse Benchmark**: Recognizing the lack of diverse benchmarks for video-conversation tasks, we propose VCGBench-Diverse, which provides 4,354 human annotated QA pairs across 18 video categories to extensively evaluate the performance of a video-conversation model.
---
## Video Annotation Pipeline (VCG+ 112K) :open_file_folder:
Video-ChatGPT introduces the VideoInstruct100K dataset, which employs a semi-automatic annotation pipeline to generate 75K instruction-tuning QA pairs. To address the limitations of this annotation process, we present \ourdata~dataset developed through an improved annotation pipeline. Our approach improves the accuracy and quality of instruction tuning pairs by improving keyframe extraction, leveraging SoTA large multimodal models (LMMs) for detailed descriptions, and refining the instruction generation strategy.
---
## VCGBench-Diverse :mag:
Recognizing the limited diversity in existing video conversation benchmarks, we introduce VCGBench-Diverse to comprehensively evaluate the generalization ability of video LMMs. While VCG-Bench provides an extensive evaluation protocol, it is limited to videos from the ActivityNet200 dataset. Our benchmark comprises a total of 877 videos, 18 broad video categories and 4,354 QA pairs, ensuring a robust evaluation framework.
---
## Installation :wrench:
We recommend setting up a conda environment for the project:
```shell
conda create --name=videogpt_plus python=3.11
conda activate videogpt_plus
git clone https://github.com/mbzuai-oryx/VideoGPT-plus
cd VideoGPT-plus
pip install torch==2.1.2 torchvision==0.16.2 --index-url https://download.pytorch.org/whl/cu118
pip install transformers==4.41.0
pip install -r requirements.txt
export PYTHONPATH="./:$PYTHONPATH"
```
Additionally, install [FlashAttention](https://github.com/HazyResearch/flash-attention) for training,
```shell
pip install ninja
git clone https://github.com/HazyResearch/flash-attention.git
cd flash-attention
python setup.py install
```
---
## Quantitative Evaluation 📊
We provide instructions to reproduce VideoGPT+ results on VCGBench, VCGBench-Diverse and MVBench. Please follow the instructions at [eval/README.md](eval/README.md).
### VCGBench Evaluation: Video-based Generative Performance Benchmarking :chart_with_upwards_trend:
---
### VCGBench-Diverse Evaluation :bar_chart:
---
### Zero-Shot Question-Answer Evaluation :question:
---
### MVBench Evaluation :movie_camera:
---
## Training :train:
We provide scripts for pretraining and finetuning of VideoGPT+. Please follow the instructions at [scripts/README.md](scripts/README.md).
---
## Qualitative Analysis :mag:
A comprehensive evaluation of VideoGPT+ performance across multiple tasks and domains.
---
---
## Acknowledgements :pray:
+ [Video-ChatGPT](https://github.com/mbzuai-oryx/Video-ChatGPT): A pioneering attempt in Video-based conversation models.
+ [LLaVA](https://github.com/haotian-liu/LLaVA): Our code base is build upon LLaVA and Video-ChatGPT.
+ [Chat-UniVi](https://github.com/PKU-YuanGroup/Chat-UniVi): A recent work in image and video-based conversation models. We borrowed some implementation details from their public codebase.
## Citations 📜:
If you're using VideoGPT+ in your research or applications, please cite using this BibTeX:
```bibtex
@article{Maaz2024VideoGPT+,
title={VideoGPT+: Integrating Image and Video Encoders for Enhanced Video Understanding},
author={Maaz, Muhammad and Rasheed, Hanoona and Khan, Salman and Khan, Fahad Shahbaz},
journal={arxiv},
year={2024},
url={https://arxiv.org/abs/2406.09418}
}
@inproceedings{Maaz2023VideoChatGPT,
title={Video-ChatGPT: Towards Detailed Video Understanding via Large Vision and Language Models},
author={Maaz, Muhammad and Rasheed, Hanoona and Khan, Salman and Khan, Fahad Shahbaz},
booktitle={Proceedings of the 62nd Annual Meeting of the Association for Computational Linguistics (ACL 2024)},
year={2024}
}
```
## License :scroll:
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
Looking forward to your feedback, contributions, and stars! :star2:
Please raise any issues or questions [here](https://github.com/mbzuai-oryx/VideoGPT-plus/issues).
---
[
](https://www.ival-mbzuai.com)
[
](https://github.com/mbzuai-oryx)
[
](https://mbzuai.ac.ae)