Update README.md


README.md

@@ -1,3 +1,233 @@
----
-license: openrail
----
+---
+license: openrail
+language:
+- en
+---
+
+# **IMageDucHaiten**
+
+*Version:* `V1.1.1`
+
+## **Table of Contents**
+
+- [Introduction](#introduction)
+- [Installation](#installation)
+- [Usage](#usage)
+- [Community and Support](#community-and-support)
+
+## **Introduction**
+
+**IMageDucHaiten** is a powerful tool, specifically designed to assist those working in artificial intelligence with the preparation of image data for training generative AI models. In version `V1.1.1`, **IMageDucHaiten** provides 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 just someone who enjoys working with images, **IMageDucHaiten** can be an invaluable tool. While it excels at supporting AI data preparation, it 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, 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.
+
+**IMageDucHaiten** is not only ideal for AI training data preparation but also serves as a versatile application for all your image processing needs.
+
+## **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/).
+   - After installation, open Visual Studio Code.
+
+4. **Activate the Virtual Environment:**
+   - Open the extracted folder in Visual Studio Code by selecting **File > Open Folder** and navigate 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 `python main.py` in the terminal.
+
+### **Option 2: Full Package Installation via Git Clone**
+
+1. **Install Git and Git LFS:**
+   - Make sure you have Git 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 the following command:
+     ```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 `python main.py` in the terminal.
+
+### **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 `python main.py` in the terminal.
+
+## **Usage**
+
+After completing the installation, you can run **IMageDucHaiten** using Visual Studio Code as follows:
+
+### **1. 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
+     ```
+
+### **2. 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.
+
+After installing Visual Studio Code and the Python extension, you can follow the instructions above to run your application.
+
+![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)
+
+## **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!