README.md

---
license: apache-2.0
language:
- en
tags:
- image-processing
- deep-learning
- AI
---
---

# IMageDucHaiten

**Version:** `V1.1.2`

## Table of Contents

- [Recent Updates](#recent-updates)
- [Introduction](#introduction)
- [Key Features](#key-features)
- [Installation](#installation)
  - [Option 1: Full Package Installation via Direct Download](#option-1-full-package-installation-via-direct-download)
  - [Option 2: Full Package Installation via Git Clone](#option-2-full-package-installation-via-git-clone)
  - [Option 3: Manual Installation by Downloading Individual Files](#option-3-manual-installation-by-downloading-individual-files)
- [Usage](#usage)
  - [Running the Application via Command Line (CMD)](#running-the-application-via-command-line-cmd)
  - [Running the Application via Visual Studio Code](#running-the-application-via-visual-studio-code)
  - [Installing Visual Studio Code](#installing-visual-studio-code)
- [Community and Support](#community-and-support)
- [Support and Contributions](#support-and-contributions)

## Recent Updates

### Version V1.1.2

Version `V1.1.2` introduces significant optimizations and new features, especially in the **Image To Caption** module. The key enhancements include:

- **Added Bit Precision Options**: Users can now select between different bit precision levels when processing images:
  - **4-bit**: Requires at least 20GB RAM and 12GB VRAM.
  - **8-bit**: Requires at least 20GB RAM and 16GB VRAM.
  - **16-bit**: Requires at least 50GB RAM and 24GB VRAM.
  - **32-bit**: Although the previous version required 40GB VRAM for 32-bit float32, this update optimizes it to run even with 24GB VRAM, though at significantly reduced speeds. This lower VRAM option is not recommended for performance-critical tasks.

> **NOTE**: Although optimization has been made to allow GPUs with lower VRAM to run at higher bit precision, the speed will be significantly reduced.

## Introduction

**IMageDucHaiten** is a powerful tool specifically designed for AI professionals to assist in the preparation of image data for training generative AI models. Version `V1.1.2` offers a suite of automated and flexible tools for processing, tagging, and captioning images, making the data preparation process more efficient and streamlined.

Whether you're an AI researcher, data engineer, or someone who enjoys working with images, **IMageDucHaiten** can be an invaluable tool. It not only excels in supporting AI data preparation but is also accessible and beneficial to anyone looking to work with images effortlessly and effectively.

## Key Features

- **Image Converter**: Convert image formats to match the requirements of your AI model, supporting a wide range of formats such as PNG, JPG, GIF, BMP, and more.
- **Image Filter**: Filter and remove images that do not meet quality criteria such as size and resolution, ensuring a clean dataset for training.
- **Rotate & Flip**: Rotate and flip images to create various training data variations, enhancing dataset diversity.
- **Image Error Fix**: Automatically detect and fix errors in images, reducing the risk of using incomplete data.
- **Image To Tag**: Automatically tag images, optimizing the data labeling process for AI models.
- **Image To Caption**: Automatically generate captions, providing context to images, useful in image recognition and captioning tasks.
- **Photo Fantasy**: Create artistic effects on images, useful for data augmentation or enhancing creative content.

![Screenshot_1.png](https://cdn-uploads.huggingface.co/production/uploads/630b58b279d18d5e53e3a5a9/Lfy93t29PfhazAAm9PzEi.png)
![Screenshot_2.png](https://cdn-uploads.huggingface.co/production/uploads/630b58b279d18d5e53e3a5a9/-YdFtf3_-hCsjykh7XkDX.png)
![Screenshot_3.png](https://cdn-uploads.huggingface.co/production/uploads/630b58b279d18d5e53e3a5a9/BLqDam81vkPpvWTKs9d42.png)
![Screenshot_4.png](https://cdn-uploads.huggingface.co/production/uploads/630b58b279d18d5e53e3a5a9/cdhsBMhFMYzuEtNj2z4Tw.png)
![Screenshot_5.png](https://cdn-uploads.huggingface.co/production/uploads/630b58b279d18d5e53e3a5a9/vtUoLEHhR5k5SIWwxEQDt.png)
![Screenshot_6.png](https://cdn-uploads.huggingface.co/production/uploads/630b58b279d18d5e53e3a5a9/MEl_THxy-7IVjvLOtUa8P.png)
![Screenshot_7.png](https://cdn-uploads.huggingface.co/production/uploads/630b58b279d18d5e53e3a5a9/ztbJOamnGoXVi49bJ0hqR.png)
![image.png](https://cdn-uploads.huggingface.co/production/uploads/630b58b279d18d5e53e3a5a9/6xkI8bdr6Py4pgO3UC0vh.png)
![Screenshot_9.png](https://cdn-uploads.huggingface.co/production/uploads/630b58b279d18d5e53e3a5a9/fI-8nFHyWx3uGlss2bnpC.png)
![Screenshot_10.png](https://cdn-uploads.huggingface.co/production/uploads/630b58b279d18d5e53e3a5a9/3L644SpuP6lFj821PoViM.png)

## Installation

To install and set up **IMageDucHaiten**, you have three options:

### Option 1: Full Package Installation via Direct Download

1. **Download the Full Package**:
   - Download the full package from the following link:
     [IMageDucHaiten-Full.zip](https://huggingface.co/DucHaiten/IMageDucHaiten-Full/tree/main)

2. **Extract the Package**:
   - Extract the contents of the `.zip` file to your desired location.

3. **Install Visual Studio Code (if not installed)**:
   - Download and install Visual Studio Code from [here](https://code.visualstudio.com/).

4. **Activate the Virtual Environment**:
   - Open the extracted folder in Visual Studio Code by selecting `File > Open Folder` and navigating to the extracted folder.
   - Open the integrated terminal within Visual Studio Code by selecting `View > Terminal`.
   - Activate the pre-configured virtual environment:
     - On **Windows**:
       ```bash
       .\venv\Scripts\activate
       ```
     - On **macOS/Linux**:
       ```bash
       source venv/bin/activate
       ```

5. **Run the Application**:
   - After activating the virtual environment, you can start the application by running:
     ```bashF
     python main.py
     ```

### Option 2: Full Package Installation via Git Clone

1. **Install Git and Git LFS**:
   - Ensure Git is installed on your system. If not, download and install it from [Git's official site](https://git-scm.com/downloads) and [Git lfs](https://git-lfs.com/)
   - Install Git LFS (Large File Storage) by running:
     ```bash
     git lfs install
     ```

2. **Clone the Repository**:
   - Use Git to clone the repository with all necessary files:
     ```bash
     git clone https://huggingface.co/DucHaiten/IMageDucHaiten
     ```

3. **Open the Project in Visual Studio Code**:
   - If you haven't installed Visual Studio Code, download and install it from [here](https://code.visualstudio.com/).
   - Open Visual Studio Code, then select `File > Open Folder` and navigate to the cloned folder.

4. **Activate the Virtual Environment**:
   - Open the integrated terminal by selecting `View > Terminal`.
   - Activate the virtual environment:
     - On **Windows**:
       ```bash
       .\venv\Scripts\activate
       ```
     - On **macOS/Linux**:
       ```bash
       source venv/bin/activate
       ```

5. **Run the Application**:
   - Start the application by running:
     ```bash
     python main.py
     ```

### Option 3: Manual Installation by Downloading Individual Files

1. **Download the Files Manually**:
   - Download individual files and directories from the repository as needed.

2. **Set up a Virtual Environment**:
   - Create and activate a virtual environment:
     - On **Windows**:
       ```bash
       python -m venv venv
       .\venv\Scripts\activate
       ```
     - On **macOS/Linux**:
       ```bash
       python3 -m venv venv
       source venv/bin/activate
       ```

3. **Install Python Dependencies**:
   - Install the required Python packages using `requirements.txt`:
     ```bash
     pip install -r requirements.txt
     ```

4. **Install External Dependencies** (Ghostscript, ImageMagick, Visual C++ Redistributable):
   - Follow the instructions provided earlier to ensure all dependencies are properly installed.

5. **Open the Project in Visual Studio Code**:
   - If you haven't installed Visual Studio Code, download and install it from [here](https://code.visualstudio.com/).
   - Open Visual Studio Code, then select `File > Open Folder` and navigate to the project folder.

6. **Run the Application**:
   - Open the integrated terminal by selecting `View > Terminal`.
   - Activate the virtual environment, then start the application by running:
     ```bash
     python main.py
     ```

## Usage

After completing the installation, you can run **IMageDucHaiten** as follows:

### Running the Application via Command Line (CMD)

1. **Activate the Virtual Environment**:
   - On **Windows**:
     ```bash
     .\venv\Scripts\activate
     ```
   - On **macOS/Linux**:
     ```bash
     source venv/bin/activate
     ```

2. **Run the Application**:
   - In the terminal, navigate to the folder where `main.py` is located.
   - Execute the following command to start the application:
     ```bash
     python main.py
     ```

### Running the Application via Visual Studio Code

1. **Open the Project in Visual Studio Code**:
   - Launch Visual Studio Code.
   - Open the project folder by selecting `File > Open Folder` and navigating to the folder where `main.py` is located.

2. **Activate the Virtual Environment**:
   - Open the integrated terminal within Visual Studio Code by selecting `View > Terminal`.
   - Activate the virtual environment:
     - On **Windows**:
       ```bash
       .\venv\Scripts\activate
       ```
     - On **macOS/Linux**:
       ```bash
       source venv/bin/activate
       ```

3. **Run the Application**:
   - In the terminal, start the application by running:
     ```bash
     python main.py
     ```
   - Alternatively, you can press **F5** to run the application with debugging.

### Installing Visual Studio Code

If you don't have Visual Studio Code installed, follow these steps:

1. **Download Visual Studio Code**:
   - Go to [Visual Studio Code's official site](https://code.visualstudio.com/).
   - Download the appropriate version for your operating system.

2. **Install Visual Studio Code**:
   - Run the installer and follow the on-screen instructions to complete the installation.

3. **Install the Python Extension**:
   - Open Visual Studio Code and go to the **Extensions** view by clicking on the square icon in the sidebar or pressing `Ctrl+Shift+X`.
   - Search for "Python" and install the extension provided by Microsoft.

## Community and Support

Join our community to stay updated, share your experiences, and get support from other users:

- **Discord Server**: Join our Discord community for discussions, support, and updates.
  - [Join Discord](https://discord.gg/vKEW6jqa49)

## Support and Contributions

If you find **IMageDucHaiten** useful and would like to support the project, consider making a donation or becoming a patron. Your contributions help in maintaining and improving the project:

- **PayPal**: You can make a one-time donation through PayPal.
  - [Donate via PayPal](https://www.paypal.com/paypalme/duchaiten)

- **Patreon**: Become a patron and support ongoing development with monthly contributions.
  - [Support on Patreon](https://www.patreon.com/duchaitenreal)

Thank you for your support!