Vid2DensePose

Overview

The Vid2DensePose is a powerful tool designed for applying the DensePose model to videos, generating detailed "Part Index" visualizations for each frame. This tool is exceptionally useful for enhancing animations, particularly when used in conjunction with MagicAnimate for temporally consistent human image animation.

Key Features

Enhanced Output: Produces video files showcasing DensePosedata in a vivid, color-coded format.
MagicAnimate Integration: Seamlessly compatible with MagicAnimate to foster advanced human animation projects.

Prerequisites

To utilize this tool, ensure the installation of:

Python 3.8 or later
PyTorch (preferably with CUDA for GPU support)
Detectron2

Installation Steps

Clone the repository:

git clone https://github.com/Flode-Labs/vid2densepose.git
cd vid2densepose

Install necessary Python packages:
```
pip install -r requirements.txt
```

Clone the Detectron repository:

git clone https://github.com/facebookresearch/detectron2.git

Usage Guide

Modify the main.py script to set your desired input (INPUT_VIDEO_PATH) and output (OUTPUT_VIDEO_PATH) video paths.
Run the script:
```
python main.py 
```

The script processes the input video and generates an output with the densePose format.

Gradio version

You can also use the Gradio to run the script with an interface. To do so, run the following command:

python app.py

Integration with MagicAnimate

For integration with MagicAnimate:

Create the densepose video using the steps outlined above.
Use this output as an input to MagicAnimate for generating temporally consistent animations.

Acknowledgments

Special thanks to:

Facebook AI Research (FAIR) for the development of DensePose.
The contributors of the Detectron2 project.
Gonzalo Vidal for the sample videos.
Sylvain Filoni for the deployment of the Gradio Space in Hugging Face.

Support

For any inquiries or support, please file an issue in our GitHub repository's issue tracker.

angelfloreso/vid2densepose