vivaa 1.0.0__tar.gz

vivaa-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Vishnu Vardhan Reddy Biyyapu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

vivaa-1.0.0/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include vivaa/images *.png

vivaa-1.0.0/PKG-INFO

@@ -0,0 +1,221 @@
+Metadata-Version: 2.1
+Name: vivaa
+Version: 1.0.0
+Summary: VIVA: Versatile Intelligent Visual Annotation Tool
+Home-page: https://github.com/your_github_username/VIVA
+Author: Vishnu Vardhan Reddy Biyyapu
+Author-email: Vishnu Vardhan Reddy Biyyapu <vardhan101101@gmail.com>
+License: MIT
+Keywords: annotation tool ai pyqt5 computer vision yolov dataset labeling image-processing vivaa
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# 🚀 VIVA: Versatile Intelligent Visual Annotation Tool ⚙️
+
+<p align="center">
+  <img src="https://img.shields.io/badge/🚀%20Boost%20Your-Speed%20of%20Annotation-brightgreen?style=for-the-badge" />
+  <img src="https://img.shields.io/badge/🧠%20Focus%20On-Accuracy%2C%20Not%20Repetition-blue?style=for-the-badge" />
+  <img src="https://img.shields.io/badge/💾%20Perfect%20For-Custom%20Dataset%20Creation-orange?style=for-the-badge" />
+</p>
+
+---
+
+## 🧠 Overview
+
+**VIVA** is a modern, **smart visual annotation tool** built with **PyQt5**, designed to streamline dataset preparation for computer vision tasks such as **object detection** and **image classification**.
+
+Whether annotating a **custom dataset** or working with a **well-organized dataset**, **VIVA** significantly reduces annotation time for users through its:
+
+- ⚡ **Intuitive Interface** — Simple, clean, and user-friendly design  
+- 🧠 **Smart Automation Techniques** — Efficient features that simplify repetitive tasks  
+- 🧩 **Optimized Workflow Design** — Smooth navigation and quick annotation management  
+
+✨ These capabilities allow annotators to focus more on **accuracy** and less on **manual repetitive work**, making **VIVA** a powerful tool for **AI developers**, **researchers**, and **dataset creators**.
+
+---
+
+## 🌟 Key Features
+
+- 🪶 User-friendly **PyQt5 GUI**  
+- 🎯 Object detection and image classification annotation modules  
+- ⌨️ Efficient keyboard shortcuts and Smart Options for fast labeling  
+- 🔍 Zoom, pan, and interactive label visualization  
+- 🧾 YOLO-compatible output formats  
+- 🧩 Modular design for future expansion (augmentation, segmentation)  
+
+---
+
+## 🧰 Object Detection Annotation
+
+VIVA’s **Object Detection Module** is packed with innovative features:  
+
+- 🎯 **Bounding Box Limits:** Set a maximum number of boxes per image; auto-switch to the next image when the limit is reached  
+- 🧠 **Smart Undo:** Press `A` to navigate to the previous image and delete the last bounding box drawn  
+- 🔺 **Flexible Shapes:** Draw rectangles, squares, circles, or polygons  
+- ⌨️ **Keyboard Shortcuts:**  
+  - `Del` → Remove boxes  
+  - `A` → Smart Previous image with Delete Function  
+  - `D` → Next image  
+  - `Enter` → Save  
+  - 🖱️ One-click mode for drawing boxes  
+- 🪟 **Interactive GUI:** Zoom, pan, color-coded boxes, and label reflector for multi-class clarity  
+- 📂 **File Navigation:** Browse images with progress tracking (e.g., “3/10”)  
+- ⚠️ **Error Handling:** Clear `QMessageBox` alerts ensure smooth operation  
+
+💡 These features make **VIVA uniquely efficient**, saving annotation time compared to other tools.
+
+---
+
+## 🖼️ Image Classification Annotation
+
+VIVA’s **Image Classification Module** streamlines labeling with:  
+
+- 🔘 **Single & Multi-Label Modes:** Toggle between single-label and multi-label modes via radio buttons  
+- 💡 **Auto-Suggestion for Labels:** Completer suggests previously used labels while typing  
+- 🪄 **Default Label Application:** Apply a default label to images using the `Space` key; single-mode overwrites existing labels with confirmation  
+- ⌨️ **Time-Saving Shortcuts:**  
+  - `D` → Next image  
+  - `A` → Previous image (clears labels for quick corrections)  
+  - `Del` → Remove selected/all labels  
+- 📁 **Efficient File Management:** Copies images to label-specific directories with progress tracking  
+- 🔍 **Interactive GUI:** Zoom in/out, reset zoom, and pan with clean layout  
+- 🪞 **Label Reflector:** Displays current labels with visual feedback  
+- ⚠️ **Robust Error Handling:** User-friendly alerts for missing directories or invalid images  
+
+⚡ These features minimize repetitive tasks, making annotation faster and more intuitive than competing tools.
+
+---
+
+## 💻 Tech Stack
+
+- 🐍 **Python** – Core logic and processing  
+- 🖥️ **PyQt5** – GUI interface  
+- 🎯 **YOLO Integration** – Optimized for object detection datasets  
+- 🧩 **Modular Design** – Scalable for future modules like augmentation or segmentation  
+
+---
+
+## 🖼 Background Image Attribution
+
+🖌️ The background image used in VIVA:
+
+- **Title:** *"4K Marvel and DC Vector Art"*  
+- **Author / Source:** Wallpapers.com  
+- **URL:** [https://wallpapers.com/wallpapers/4k-marvel-and-dc-vector-art-pmkg7yqt3zz8bmcc.html](https://wallpapers.com/wallpapers/4k-marvel-and-dc-vector-art-pmkg7yqt3zz8bmcc.html)  
+- **License:** Free, Attribution required  
+- **Modifications:** Color filters applied for VIVA’s UI  
+
+✅ This attribution satisfies the license requirement and ensures legal usage.
+
+---
+
+## 🔮 Future Works
+
+🚧 The following modules are planned for future development:
+
+- 🧬 **Data Augmentation Tool** – To enhance datasets with transformations and increase model robustness  
+- 🎨 **Instance Segmentation & Key Point Detection Tools** – For detailed labeling in complex vision tasks  
+- 👨‍💻 All future updates will be developed solely by the project author  
+
+---
+
+## 🪪 License
+
+This project is licensed under the MIT License
+. © 2025 Vishnu Vardhan Reddy Biyyapu
+
+---
+
+## 📦 Installation
+
+Follow these steps to install and run **VIVA**:
+
+
+
+### 1. Install Python
+
+Make sure you have **Python 3.8 or higher** installed:
+
+```bash
+python --version
+```
+---
+## 2. Create a Virtual Environment (Recommended)
+
+It’s recommended to use a virtual environment to avoid conflicts with other Python packages:
+
+```bash
+python -m venv viva_env
+```
+
+Activate the environment:
+
+- Windows:
+```bash
+viva_env\Scripts\activate
+```
+- Linux / macOS:
+```bash
+source viva_env/bin/activate
+```
+---
+## 3. Install Required Packages
+
+- Before running VIVA, install all required packages listed in requirements.txt:
+```bash
+pip install -r requirements.txt
+```
+
+This ensures all Python dependencies needed for VIVA are installed correctly.
+⚠️ Note: Installing from PyPI (pip install viva) will also install these dependencies automatically.
+---
+## 4. Install and Run VIVA
+
+After dependencies are installed:
+
+From terminal/command prompt:
+```bash
+vivaa
+```
+
+From Python script:
+```bash
+from vivaa.main import main
+main()
+```
+---
+## 🛠 Workflow & Help Section
+
+After successfully installing and running **VIVA** (`viva` command), you can access the **Help Section** directly from the application to learn about its workflow, shortcuts, and smart options designed for faster annotation.
+
+### How to Access Help:
+
+1. Launch VIVA using the terminal or command prompt:
+
+```bash
+vivaa
+```
+2. In the main VIVA window, hover your mouse over the title bar “VIVA □ ▭ ○”.
+3. Click on the title — this will open the Help Section.
+
+--
+
+## 🎥 Demo Video
+
+See **VIVA in action**! Watch a short demo showing the object detection and image classification modules, shortcuts, and smart options in real-time.
+
+🔗 [Watch the demo of Object Detection Annotation Tool on LinkedIn](https://www.linkedin.com/feed/update/urn:li:activity:7354882949181292544/)
+
+🔗 [Watch the demo of Image Classification Tool on LinkedIn](https://www.linkedin.com/feed/update/urn:li:activity:7357883048501108736/)
+> Note: The video showcases VIVA’s workflow, time-saving features, and user-friendly interface for dataset annotation.

vivaa-1.0.0/README.md

@@ -0,0 +1,198 @@
+# 🚀 VIVA: Versatile Intelligent Visual Annotation Tool ⚙️
+
+<p align="center">
+  <img src="https://img.shields.io/badge/🚀%20Boost%20Your-Speed%20of%20Annotation-brightgreen?style=for-the-badge" />
+  <img src="https://img.shields.io/badge/🧠%20Focus%20On-Accuracy%2C%20Not%20Repetition-blue?style=for-the-badge" />
+  <img src="https://img.shields.io/badge/💾%20Perfect%20For-Custom%20Dataset%20Creation-orange?style=for-the-badge" />
+</p>
+
+---
+
+## 🧠 Overview
+
+**VIVA** is a modern, **smart visual annotation tool** built with **PyQt5**, designed to streamline dataset preparation for computer vision tasks such as **object detection** and **image classification**.
+
+Whether annotating a **custom dataset** or working with a **well-organized dataset**, **VIVA** significantly reduces annotation time for users through its:
+
+- ⚡ **Intuitive Interface** — Simple, clean, and user-friendly design  
+- 🧠 **Smart Automation Techniques** — Efficient features that simplify repetitive tasks  
+- 🧩 **Optimized Workflow Design** — Smooth navigation and quick annotation management  
+
+✨ These capabilities allow annotators to focus more on **accuracy** and less on **manual repetitive work**, making **VIVA** a powerful tool for **AI developers**, **researchers**, and **dataset creators**.
+
+---
+
+## 🌟 Key Features
+
+- 🪶 User-friendly **PyQt5 GUI**  
+- 🎯 Object detection and image classification annotation modules  
+- ⌨️ Efficient keyboard shortcuts and Smart Options for fast labeling  
+- 🔍 Zoom, pan, and interactive label visualization  
+- 🧾 YOLO-compatible output formats  
+- 🧩 Modular design for future expansion (augmentation, segmentation)  
+
+---
+
+## 🧰 Object Detection Annotation
+
+VIVA’s **Object Detection Module** is packed with innovative features:  
+
+- 🎯 **Bounding Box Limits:** Set a maximum number of boxes per image; auto-switch to the next image when the limit is reached  
+- 🧠 **Smart Undo:** Press `A` to navigate to the previous image and delete the last bounding box drawn  
+- 🔺 **Flexible Shapes:** Draw rectangles, squares, circles, or polygons  
+- ⌨️ **Keyboard Shortcuts:**  
+  - `Del` → Remove boxes  
+  - `A` → Smart Previous image with Delete Function  
+  - `D` → Next image  
+  - `Enter` → Save  
+  - 🖱️ One-click mode for drawing boxes  
+- 🪟 **Interactive GUI:** Zoom, pan, color-coded boxes, and label reflector for multi-class clarity  
+- 📂 **File Navigation:** Browse images with progress tracking (e.g., “3/10”)  
+- ⚠️ **Error Handling:** Clear `QMessageBox` alerts ensure smooth operation  
+
+💡 These features make **VIVA uniquely efficient**, saving annotation time compared to other tools.
+
+---
+
+## 🖼️ Image Classification Annotation
+
+VIVA’s **Image Classification Module** streamlines labeling with:  
+
+- 🔘 **Single & Multi-Label Modes:** Toggle between single-label and multi-label modes via radio buttons  
+- 💡 **Auto-Suggestion for Labels:** Completer suggests previously used labels while typing  
+- 🪄 **Default Label Application:** Apply a default label to images using the `Space` key; single-mode overwrites existing labels with confirmation  
+- ⌨️ **Time-Saving Shortcuts:**  
+  - `D` → Next image  
+  - `A` → Previous image (clears labels for quick corrections)  
+  - `Del` → Remove selected/all labels  
+- 📁 **Efficient File Management:** Copies images to label-specific directories with progress tracking  
+- 🔍 **Interactive GUI:** Zoom in/out, reset zoom, and pan with clean layout  
+- 🪞 **Label Reflector:** Displays current labels with visual feedback  
+- ⚠️ **Robust Error Handling:** User-friendly alerts for missing directories or invalid images  
+
+⚡ These features minimize repetitive tasks, making annotation faster and more intuitive than competing tools.
+
+---
+
+## 💻 Tech Stack
+
+- 🐍 **Python** – Core logic and processing  
+- 🖥️ **PyQt5** – GUI interface  
+- 🎯 **YOLO Integration** – Optimized for object detection datasets  
+- 🧩 **Modular Design** – Scalable for future modules like augmentation or segmentation  
+
+---
+
+## 🖼 Background Image Attribution
+
+🖌️ The background image used in VIVA:
+
+- **Title:** *"4K Marvel and DC Vector Art"*  
+- **Author / Source:** Wallpapers.com  
+- **URL:** [https://wallpapers.com/wallpapers/4k-marvel-and-dc-vector-art-pmkg7yqt3zz8bmcc.html](https://wallpapers.com/wallpapers/4k-marvel-and-dc-vector-art-pmkg7yqt3zz8bmcc.html)  
+- **License:** Free, Attribution required  
+- **Modifications:** Color filters applied for VIVA’s UI  
+
+✅ This attribution satisfies the license requirement and ensures legal usage.
+
+---
+
+## 🔮 Future Works
+
+🚧 The following modules are planned for future development:
+
+- 🧬 **Data Augmentation Tool** – To enhance datasets with transformations and increase model robustness  
+- 🎨 **Instance Segmentation & Key Point Detection Tools** – For detailed labeling in complex vision tasks  
+- 👨‍💻 All future updates will be developed solely by the project author  
+
+---
+
+## 🪪 License
+
+This project is licensed under the MIT License
+. © 2025 Vishnu Vardhan Reddy Biyyapu
+
+---
+
+## 📦 Installation
+
+Follow these steps to install and run **VIVA**:
+
+
+
+### 1. Install Python
+
+Make sure you have **Python 3.8 or higher** installed:
+
+```bash
+python --version
+```
+---
+## 2. Create a Virtual Environment (Recommended)
+
+It’s recommended to use a virtual environment to avoid conflicts with other Python packages:
+
+```bash
+python -m venv viva_env
+```
+
+Activate the environment:
+
+- Windows:
+```bash
+viva_env\Scripts\activate
+```
+- Linux / macOS:
+```bash
+source viva_env/bin/activate
+```
+---
+## 3. Install Required Packages
+
+- Before running VIVA, install all required packages listed in requirements.txt:
+```bash
+pip install -r requirements.txt
+```
+
+This ensures all Python dependencies needed for VIVA are installed correctly.
+⚠️ Note: Installing from PyPI (pip install viva) will also install these dependencies automatically.
+---
+## 4. Install and Run VIVA
+
+After dependencies are installed:
+
+From terminal/command prompt:
+```bash
+vivaa
+```
+
+From Python script:
+```bash
+from vivaa.main import main
+main()
+```
+---
+## 🛠 Workflow & Help Section
+
+After successfully installing and running **VIVA** (`viva` command), you can access the **Help Section** directly from the application to learn about its workflow, shortcuts, and smart options designed for faster annotation.
+
+### How to Access Help:
+
+1. Launch VIVA using the terminal or command prompt:
+
+```bash
+vivaa
+```
+2. In the main VIVA window, hover your mouse over the title bar “VIVA □ ▭ ○”.
+3. Click on the title — this will open the Help Section.
+
+--
+
+## 🎥 Demo Video
+
+See **VIVA in action**! Watch a short demo showing the object detection and image classification modules, shortcuts, and smart options in real-time.
+
+🔗 [Watch the demo of Object Detection Annotation Tool on LinkedIn](https://www.linkedin.com/feed/update/urn:li:activity:7354882949181292544/)
+
+🔗 [Watch the demo of Image Classification Tool on LinkedIn](https://www.linkedin.com/feed/update/urn:li:activity:7357883048501108736/)
+> Note: The video showcases VIVA’s workflow, time-saving features, and user-friendly interface for dataset annotation.

vivaa-1.0.0/pyproject.toml

@@ -0,0 +1,16 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "vivaa"
+version = "1.0.0"
+description = "VIVA: Versatile Intelligent Visual Annotation Tool"
+authors = [{ name = "Vishnu Vardhan Reddy Biyyapu", email = "vardhan101101@gmail.com" }]
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.8"
+
+[tool.setuptools]
+include-package-data = true
+packages = ["vivaa"]

vivaa-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

vivaa-1.0.0/setup.py

@@ -0,0 +1,86 @@
+from setuptools import setup, find_packages
+from pathlib import Path
+
+# Read the README file for long description
+this_directory = Path(__file__).parent
+readme_path = this_directory / "README.md"
+long_description = readme_path.read_text(encoding="utf-8") if readme_path.exists() else ""
+
+setup(
+    name="vivaa",  # lowercase is best for PyPI package name
+    version="1.0.0",
+    author="Vishnu Vardhan Reddy Biyyapu",
+    author_email="vardhan101101@gmail.com",
+    description="VIVA – Versatile Intelligent Visual Annotator",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/your_github_username/VIVA",
+    packages=find_packages(exclude=("tests", "docs", "examples")),
+    include_package_data=True,
+    install_requires=[
+        "absl-py>=2.3.0",
+        "albumentations>=2.0.6",
+        "attrs>=25.3.0",
+        "autopy>=4.0.1",
+        "certifi>=2025.4.26",
+        "cffi>=1.17.1",
+        "colorama>=0.4.6",
+        "cycler>=0.12.1",
+        "docutils>=0.22.2",
+        "filelock>=3.18.0",
+        "flatbuffers>=25.2.10",
+        "fonttools>=4.56.0",
+        "fsspec>=2025.3.2",
+        "jax>=0.6.1",
+        "jaxlib>=0.6.1",
+        "Jinja2>=3.1.6",
+        "kiwisolver>=1.4.8",
+        "matplotlib>=3.10.1",
+        "ml_dtypes>=0.5.1",
+        "numpy>=1.26.4",
+        "opencv-contrib-python>=4.11.0.86",
+        "opencv-python>=4.11.0.86",
+        "opencv-python-headless>=4.11.0.86",
+        "opt_einsum>=3.4.0",
+        "pandas>=2.2.3",
+        "pillow>=11.1.0",
+        "pycparser>=2.22",
+        "pydantic>=2.11.4",
+        "PyQt5>=5.15.11",
+        "PyQt5-Qt5>=5.15.2",
+        "PyQt5_sip>=12.17.0",
+        "PyYAML>=6.0.2",
+        "requests>=2.32.3",
+        "scipy>=1.15.3",
+        "seaborn>=0.13.2",
+        "sentencepiece>=0.2.0",
+        "sounddevice>=0.5.2",
+        "torch>=2.7.0",
+        "torchvision>=0.22.0",
+        "tqdm>=4.67.1",
+        "typing_extensions>=4.13.2",
+        "ultralytics>=8.3.133",
+    ],
+    entry_points={
+        "console_scripts": [
+            "vivaa=vivaa.main:main",  # allows `vivaa` command to run your app
+        ],
+    },
+    keywords=(
+        "annotation tool ai pyqt5 computer vision yolov dataset labeling "
+        "image-processing vivaa"
+    ),
+    classifiers=[
+        "Development Status :: 5 - Production/Stable",
+        "Intended Audience :: Developers",
+        "Intended Audience :: Education",
+        "Topic :: Software Development :: Build Tools",
+        "Topic :: Software Development :: User Interfaces",
+        "Topic :: Scientific/Engineering :: Artificial Intelligence",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.10",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.8",
+)

vivaa-1.0.0/vivaa/__init__.py

@@ -0,0 +1,5 @@
+from .backup_annotation_pyqt5 import AnnotationTool
+from .imageclassification_pyqt5 import ClassificationTool
+
+from .fun_pyqt5 import MainWindow
+from .main import main

vivaa-1.0.0/vivaa/__main__.py

@@ -0,0 +1,4 @@
+from .main import main
+
+if __name__ == "__main__":
+    main()