Metadata-Version: 2.4
Name: vut
Version: 0.1.3
Summary: Toolkit for Video Understanding tasks
Author-email: kage1020 <contact@kage1020.com>
License-Expression: MIT
Project-URL: Repository, https://github.com/kage1020/vut.git
Keywords: video,computer vision,deep learning,action recognition,action detection,action localization,action segmentation,video classification,video segmentation,video generation,video captioning,video retrieval,video understanding,video analysis,video processing
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: einops>=0.8.1
Requires-Dist: ffmpeg-python>=0.2.0
Requires-Dist: hydra-core>=1.3.2
Requires-Dist: matplotlib>=3.10.3
Requires-Dist: numpy>=2.2.5
Requires-Dist: opencv-contrib-python>=4.11.0.86
Requires-Dist: opencv-python>=4.11.0.86
Requires-Dist: pillow>=11.2.1
Requires-Dist: polars>=1.29.0
Requires-Dist: python-dotenv>=1.1.0
Requires-Dist: rich>=14.0.0
Requires-Dist: torch>=2.7.0
Requires-Dist: torchtyping>=0.1.5
Requires-Dist: torchvision>=0.22.0
Dynamic: license-file

<h1 align="center">Video Understanding Toolkit</h1>

<p align="center">
  <a href="https://github.com/kage1020/vut">
    <img src="https://img.shields.io/github/stars/kage1020/vut" alt="Stars" />
  </a>
  <a href="https://github.com/kage1020/vut/blob/main/LICENSE">
    <img src="https://img.shields.io/github/license/kage1020/vut" alt="License" />
  </a>
  <a href="https://pypi.org/project/vut/">
    <img src="https://img.shields.io/pypi/v/vut" alt="Latest Release" />
  </a>
  <a href="https://codecov.io/gh/kage1020/vut" >
   <img src="https://codecov.io/gh/kage1020/vut/graph/badge.svg?token=XWNCMG995B"/>
  </a>
</p>


This repository provides a collection of tools and utilities for video understanding tasks, including video classification, action recognition, and more. The toolkit is designed to be modular and extensible, allowing researchers and developers to easily integrate new models and datasets.

## Features

TODO: Implement the features and tools in the toolkit.

## Installation

You can install the toolkit using pip:

```bash
pip install vut
```

## Usage

TODO: Provide usage examples and documentation for the various features and tools in the toolkit.

## Development

This toolkit requires package management tool [uv](https://docs.astral.sh/uv). You first need to install it:

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

Then, you can install the toolkit using the following command:

```bash
git clone https://github.com/kage1020/vut.git
cd vut
uv venv
uv sync
```

This will install all the required dependencies and set up the development environment.

## License

The core functionality of this toolkit is licensed under the [MIT License](LICENSE).

However, the models included in the `vut/models` directory may be subject to different licenses:

- Each model implementation in the `vut/models` directory includes its own licensing information.
- Please refer to the [models README](vut/models/README.md) for specific license details of each model.

When using this toolkit, especially when incorporating the provided models, please make sure to comply with the respective licenses.

## Contributing

We welcome contributions to the toolkit!
