README.md

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

# IMageDucHaiten

**Version:** `V1.1.1`

## Table of Contents

- [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)

## 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.1` 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.
- **Shuffle Image**: Shuffle or sequence images to create a diverse dataset, suitable for analysis and modeling tasks.

![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)
![Screenshot_8.png](https://cdn-uploads.huggingface.co/production/uploads/630b58b279d18d5e53e3a5a9/qw3osuCswU_8UaLqrshHY.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_v1.1.1-Full.zip](https://huggingface.co./DucHaiten/IMageDucHaiten-Full/resolve/main/IMageDucHaiten_v1.1.1-Full.zip)

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:
     ```bash
     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).
   - 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!