a Video Quality Analysis Toolkit
14
stars
159
commits
Python
primary language
May 16, 2025
updated
AIGVE?AIGVE (AI Generated Video Evaluation Toolkit) provides a comprehensive and structured evaluation framework for assessing AI-generated video quality developed by the IFM Lab. It integrates multiple evaluation metrics, covering diverse aspects of video evaluation, including neural-network-based assessment, distribution comparison, vision-language alignment, and multi-faceted analysis.

| Components | Descriptions |
|---|---|
aigve | The library for assessing AI-generated video quality |
aigve.configs | a library for parameter configuration and management |
aigve.core | a library for video evaluation process design |
aigve.datasets | a library for dataset loading design |
aigve.metrics | a library for video evaluation metrics design and building |
aigve.utils | a library for utility function definition |
These metrics assess the quality of generated videos by comparing the distribution of real and generated samples.
These metrics leverage deep learning models to assess AI-generated video quality based on learned representations.
These metrics evaluate alignment, similarity, and coherence between visual and textual representations, often using embeddings from models like CLIP and BLIP.
These metrics assess higher-level understanding, reasoning, and factual consistency in vision-language models.
These metrics integrate structured, multi-dimensional assessments to provide a holistic benchmarking framework for AI-generated videos.
The aigve library has been published at both PyPI and the project github repository.
To install aigve from PyPI, use the following command:
pip install aigve
You can also install aigve from the source code, which has been released at the
project github repository.
You can download the public repository either from the project github webpage or via the following command:
git clone https://github.com/ShaneXiangH/AIGVE_Tool.git
Please check the installation page for dependency packages.
conda env remove --name aigve
conda env create -f environment.yml
conda activate aigve
conda install pytorch==2.1.0 torchvision==0.16.0 torchaudio==2.1.0 pytorch-cuda=11.8 -c pytorch -c nvidia
python main.py {metric_config_file}.py
Take Examples:
rm -rf ~/.cache
cd AIGVE_Tool/aigve
For GSTVQA:
python main_aigve.py AIGVE_Tool/aigve/configs/gstvqa.py --work-dir ./output
For SimpleVQA:
python main_aigve.py AIGVE_Tool/aigve/configs/simplevqa.py --work-dir ./output
For LightVQAPlus:
python main_aigve.py AIGVE_Tool/aigve/configs/lightvqa_plus.py --work-dir ./output
For CLIPSim:
python main_aigve.py AIGVE_Tool/aigve/configs/clipsim.py --work-dir ./output
For VideoPhy:
python main_aigve.py AIGVE_Tool/aigve/configs/clipsim.py --work-dir ./output
aigve is developed based on the AIGVE-Tool paper from IFM Lab, which can be downloaded via the following links:
If you find AIGVE library and the AIGVE-Tool papers useful in your work, please cite the papers as follows:
@article{xiang2025aigvetoolaigeneratedvideoevaluation,
title={AIGVE-Tool: AI-Generated Video Evaluation Toolkit with Multifaceted Benchmark},
author={Xinhao Xiang and Xiao Liu and Zizhong Li and Zhuosheng Liu and Jiawei Zhang},
year={2025},
journal={arXiv preprint arXiv:2503.14064},
eprint={2503.14064},
archivePrefix={arXiv},
primaryClass={cs.CV},
url={https://arxiv.org/abs/2503.14064},
}
The Toolkit is build top the top of MMEngine
We acknowledge original repositories of various AIGVE methods: GSTVQA, CLIPSim,
Python
100.0%
a Video Quality Analysis Toolkit
14
stars
159
commits
Python
primary language
May 16, 2025
updated
AIGVE?AIGVE (AI Generated Video Evaluation Toolkit) provides a comprehensive and structured evaluation framework for assessing AI-generated video quality developed by the IFM Lab. It integrates multiple evaluation metrics, covering diverse aspects of video evaluation, including neural-network-based assessment, distribution comparison, vision-language alignment, and multi-faceted analysis.

| Components | Descriptions |
|---|---|
aigve | The library for assessing AI-generated video quality |
aigve.configs | a library for parameter configuration and management |
aigve.core | a library for video evaluation process design |
aigve.datasets | a library for dataset loading design |
aigve.metrics | a library for video evaluation metrics design and building |
aigve.utils | a library for utility function definition |
These metrics assess the quality of generated videos by comparing the distribution of real and generated samples.
These metrics leverage deep learning models to assess AI-generated video quality based on learned representations.
These metrics evaluate alignment, similarity, and coherence between visual and textual representations, often using embeddings from models like CLIP and BLIP.
These metrics assess higher-level understanding, reasoning, and factual consistency in vision-language models.
These metrics integrate structured, multi-dimensional assessments to provide a holistic benchmarking framework for AI-generated videos.
The aigve library has been published at both PyPI and the project github repository.
To install aigve from PyPI, use the following command:
pip install aigve
You can also install aigve from the source code, which has been released at the
project github repository.
You can download the public repository either from the project github webpage or via the following command:
git clone https://github.com/ShaneXiangH/AIGVE_Tool.git
Please check the installation page for dependency packages.
conda env remove --name aigve
conda env create -f environment.yml
conda activate aigve
conda install pytorch==2.1.0 torchvision==0.16.0 torchaudio==2.1.0 pytorch-cuda=11.8 -c pytorch -c nvidia
python main.py {metric_config_file}.py
Take Examples:
rm -rf ~/.cache
cd AIGVE_Tool/aigve
For GSTVQA:
python main_aigve.py AIGVE_Tool/aigve/configs/gstvqa.py --work-dir ./output
For SimpleVQA:
python main_aigve.py AIGVE_Tool/aigve/configs/simplevqa.py --work-dir ./output
For LightVQAPlus:
python main_aigve.py AIGVE_Tool/aigve/configs/lightvqa_plus.py --work-dir ./output
For CLIPSim:
python main_aigve.py AIGVE_Tool/aigve/configs/clipsim.py --work-dir ./output
For VideoPhy:
python main_aigve.py AIGVE_Tool/aigve/configs/clipsim.py --work-dir ./output
aigve is developed based on the AIGVE-Tool paper from IFM Lab, which can be downloaded via the following links:
If you find AIGVE library and the AIGVE-Tool papers useful in your work, please cite the papers as follows:
@article{xiang2025aigvetoolaigeneratedvideoevaluation,
title={AIGVE-Tool: AI-Generated Video Evaluation Toolkit with Multifaceted Benchmark},
author={Xinhao Xiang and Xiao Liu and Zizhong Li and Zhuosheng Liu and Jiawei Zhang},
year={2025},
journal={arXiv preprint arXiv:2503.14064},
eprint={2503.14064},
archivePrefix={arXiv},
primaryClass={cs.CV},
url={https://arxiv.org/abs/2503.14064},
}
The Toolkit is build top the top of MMEngine
We acknowledge original repositories of various AIGVE methods: GSTVQA, CLIPSim,
Python
100.0%