lazylabel-gui 1.1.5__tar.gz → 1.1.7__tar.gz

lazylabel_gui-1.1.7/PKG-INFO

@@ -0,0 +1,240 @@
+Metadata-Version: 2.4
+Name: lazylabel-gui
+Version: 1.1.7
+Summary: An image segmentation GUI for generating ML ready mask tensors and annotations.
+Author-email: "Deniz N. Cakan" <deniz.n.cakan@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Deniz N. Cakan
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/dnzckn/lazylabel
+Project-URL: Bug Tracker, https://github.com/dnzckn/lazylabel/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Classifier: Environment :: X11 Applications :: Qt
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyQt6>=6.9.0
+Requires-Dist: pyqtdarktheme==2.1.0
+Requires-Dist: torch>=2.7.1
+Requires-Dist: torchvision>=0.22.1
+Requires-Dist: segment-anything==1.0
+Requires-Dist: numpy>=2.1.2
+Requires-Dist: opencv-python>=4.11.0.86
+Requires-Dist: scipy>=1.15.3
+Requires-Dist: requests>=2.32.4
+Requires-Dist: tqdm>=4.67.1
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: pytest-qt>=4.2.0; extra == "dev"
+Requires-Dist: ruff>=0.8.0; extra == "dev"
+Dynamic: license-file
+
+# <img src="https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/logo2.png" alt="LazyLabel Logo" style="height:60px; vertical-align:middle;" /> <img src="https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/logo_black.png" alt="LazyLabel Cursive" style="height:60px; vertical-align:middle;" />
+
+**AI-Assisted Image Segmentation Made Simple**
+
+LazyLabel combines Meta's Segment Anything Model (SAM) with intuitive editing tools for fast, precise image labeling. Perfect for machine learning datasets, computer vision research, and annotation workflows.
+
+![LazyLabel Screenshot](https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/gui.PNG)
+
+---
+
+## 🚀 Quick Start
+
+### Installation
+```bash
+pip install lazylabel-gui
+lazylabel-gui
+```
+
+### Usage
+1. **Open Folder** → Select your image directory
+2. **Click on image** → AI generates instant masks  
+3. **Fine-tune** → Edit polygons, merge segments, adjust classes
+4. **Export** → Clean `.npz` files ready for ML training
+
+---
+
+## ✨ Key Features
+
+### **🧠 AI-Powered Segmentation**
+- **One-click masking** with Meta's SAM model
+- **Smart prompting** via positive/negative points
+- **Fragment filtering** to remove small artifacts
+- **Multiple model support** (VIT-H, VIT-L, VIT-B)
+
+### **🎨 Advanced Editing**
+- **Polygon drawing** with full vertex control
+- **Bounding box** annotation mode
+- **Shape merging** and class assignment
+- **Edit mode** for precision adjustments
+
+### **⚡ Productivity Tools**
+- **Image adjustments** (brightness, contrast, gamma) 
+- **Customizable hotkeys** for all functions
+- **Undo/redo** with full history
+- **Auto-save** and session persistence
+
+### **📊 ML-Ready Outputs**
+- **One-hot encoded** `.npz` format
+- **Clean class separation** with shape `(H, W, Classes)`
+- **Batch processing** support
+- **Existing mask loading** for iterative work
+
+---
+
+## ⌨️ Essential Controls
+
+| Mode | Key | Action |
+|------|-----|--------|
+| **AI Segmentation** | `1` | Point mode for SAM |
+| | `Left Click` | Add positive point |
+| | `Right Click` | Add negative point |
+| | `Space` | Save segment |
+| **Manual Drawing** | `2` | Polygon mode |
+| | `Left Click` | Add vertex |
+| | `Enter` | Close polygon |
+| **Editing** | `E` | Selection mode |
+| | `R` | Edit selected shapes |
+| | `M` | Merge selected segments |
+| **Navigation** | `Q` | Pan mode |
+| | `W/A/S/D` | Pan image |
+| | `Scroll` | Zoom in/out |
+
+**💡 All hotkeys are customizable** - Click "Hotkeys" button to personalize shortcuts
+
+---
+
+## 📦 Output Format
+
+LazyLabel exports clean, ML-ready data:
+
+```python
+import numpy as np
+
+# Load your labeled data
+data = np.load('your_image.npz')
+mask = data['mask']  # Shape: (height, width, num_classes)
+
+# Each channel is a binary mask for one class
+class_0_mask = mask[:, :, 0]  # Binary mask for class 0
+class_1_mask = mask[:, :, 1]  # Binary mask for class 1
+# ... and so on
+```
+
+**Perfect for:**
+- Semantic segmentation training
+- Instance segmentation datasets  
+- Computer vision research
+- Automated annotation pipelines
+
+---
+
+## 🛠️ Advanced Features
+
+### **Image Enhancement**
+- **Brightness/Contrast** adjustment sliders
+- **Gamma correction** for better visibility
+- **Live preview** of adjustments
+- **SAM integration** with adjusted images
+
+### **Smart Filtering**
+- **Fragment threshold** removes small segments
+- **Size-based filtering** (0-100% of largest segment)
+- **Quality control** for clean annotations
+
+### **Professional Workflow**
+- **Class management** with custom aliases
+- **Segment organization** with sortable tables
+- **Batch export** for large datasets
+- **Model switching** without restart
+
+---
+
+## 🏗️ Development
+
+### Installation from Source
+```bash
+git clone https://github.com/dnzckn/LazyLabel.git
+cd LazyLabel
+pip install -e .
+lazylabel-gui
+```
+
+### Code Quality & Testing
+```bash
+# Linting & formatting
+ruff check . && ruff format .
+
+# Run tests with coverage
+python -m pytest --cov=lazylabel --cov-report=html
+
+# All tests pass with 60%+ coverage
+```
+
+### Architecture
+- **Modular design** with clean separation of concerns
+- **Signal-based communication** between components  
+- **Extensible model system** for new SAM variants
+- **Comprehensive test suite** with 95% speed optimization
+
+---
+
+## 📋 Requirements
+
+- **Python 3.10+**
+- **OpenCV** for image processing
+- **PyQt6** for GUI
+- **NumPy** for data handling
+- **2.5GB** disk space for SAM model (auto-downloaded)
+
+---
+
+## 🤝 Contributing
+
+LazyLabel welcomes contributions! Check out our:
+- [Architecture Guide](src/lazylabel/ARCHITECTURE.md) for technical details
+- [Hotkey System](src/lazylabel/HOTKEY_FEATURE.md) for customization
+- Issues page for feature requests and bug reports
+
+---
+
+## 🙏 Acknowledgments
+
+LazyLabel was inspired by and builds upon the excellent work of:
+- [LabelMe](https://github.com/wkentaro/labelme) - The pioneering open-source image annotation tool
+- [Segment-Anything-UI](https://github.com/branislavhesko/segment-anything-ui) - Early SAM integration concepts
+
+---
+
+## ☕ Support
+
+If LazyLabel saves you time on annotation tasks, [consider supporting the project!](https://buymeacoffee.com/dnzckn)
+
+---
+
+**Made with ❤️ for the computer vision community**

lazylabel_gui-1.1.7/README.md

@@ -0,0 +1,185 @@
+# <img src="https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/logo2.png" alt="LazyLabel Logo" style="height:60px; vertical-align:middle;" /> <img src="https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/logo_black.png" alt="LazyLabel Cursive" style="height:60px; vertical-align:middle;" />
+
+**AI-Assisted Image Segmentation Made Simple**
+
+LazyLabel combines Meta's Segment Anything Model (SAM) with intuitive editing tools for fast, precise image labeling. Perfect for machine learning datasets, computer vision research, and annotation workflows.
+
+![LazyLabel Screenshot](https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/gui.PNG)
+
+---
+
+## 🚀 Quick Start
+
+### Installation
+```bash
+pip install lazylabel-gui
+lazylabel-gui
+```
+
+### Usage
+1. **Open Folder** → Select your image directory
+2. **Click on image** → AI generates instant masks  
+3. **Fine-tune** → Edit polygons, merge segments, adjust classes
+4. **Export** → Clean `.npz` files ready for ML training
+
+---
+
+## ✨ Key Features
+
+### **🧠 AI-Powered Segmentation**
+- **One-click masking** with Meta's SAM model
+- **Smart prompting** via positive/negative points
+- **Fragment filtering** to remove small artifacts
+- **Multiple model support** (VIT-H, VIT-L, VIT-B)
+
+### **🎨 Advanced Editing**
+- **Polygon drawing** with full vertex control
+- **Bounding box** annotation mode
+- **Shape merging** and class assignment
+- **Edit mode** for precision adjustments
+
+### **⚡ Productivity Tools**
+- **Image adjustments** (brightness, contrast, gamma) 
+- **Customizable hotkeys** for all functions
+- **Undo/redo** with full history
+- **Auto-save** and session persistence
+
+### **📊 ML-Ready Outputs**
+- **One-hot encoded** `.npz` format
+- **Clean class separation** with shape `(H, W, Classes)`
+- **Batch processing** support
+- **Existing mask loading** for iterative work
+
+---
+
+## ⌨️ Essential Controls
+
+| Mode | Key | Action |
+|------|-----|--------|
+| **AI Segmentation** | `1` | Point mode for SAM |
+| | `Left Click` | Add positive point |
+| | `Right Click` | Add negative point |
+| | `Space` | Save segment |
+| **Manual Drawing** | `2` | Polygon mode |
+| | `Left Click` | Add vertex |
+| | `Enter` | Close polygon |
+| **Editing** | `E` | Selection mode |
+| | `R` | Edit selected shapes |
+| | `M` | Merge selected segments |
+| **Navigation** | `Q` | Pan mode |
+| | `W/A/S/D` | Pan image |
+| | `Scroll` | Zoom in/out |
+
+**💡 All hotkeys are customizable** - Click "Hotkeys" button to personalize shortcuts
+
+---
+
+## 📦 Output Format
+
+LazyLabel exports clean, ML-ready data:
+
+```python
+import numpy as np
+
+# Load your labeled data
+data = np.load('your_image.npz')
+mask = data['mask']  # Shape: (height, width, num_classes)
+
+# Each channel is a binary mask for one class
+class_0_mask = mask[:, :, 0]  # Binary mask for class 0
+class_1_mask = mask[:, :, 1]  # Binary mask for class 1
+# ... and so on
+```
+
+**Perfect for:**
+- Semantic segmentation training
+- Instance segmentation datasets  
+- Computer vision research
+- Automated annotation pipelines
+
+---
+
+## 🛠️ Advanced Features
+
+### **Image Enhancement**
+- **Brightness/Contrast** adjustment sliders
+- **Gamma correction** for better visibility
+- **Live preview** of adjustments
+- **SAM integration** with adjusted images
+
+### **Smart Filtering**
+- **Fragment threshold** removes small segments
+- **Size-based filtering** (0-100% of largest segment)
+- **Quality control** for clean annotations
+
+### **Professional Workflow**
+- **Class management** with custom aliases
+- **Segment organization** with sortable tables
+- **Batch export** for large datasets
+- **Model switching** without restart
+
+---
+
+## 🏗️ Development
+
+### Installation from Source
+```bash
+git clone https://github.com/dnzckn/LazyLabel.git
+cd LazyLabel
+pip install -e .
+lazylabel-gui
+```
+
+### Code Quality & Testing
+```bash
+# Linting & formatting
+ruff check . && ruff format .
+
+# Run tests with coverage
+python -m pytest --cov=lazylabel --cov-report=html
+
+# All tests pass with 60%+ coverage
+```
+
+### Architecture
+- **Modular design** with clean separation of concerns
+- **Signal-based communication** between components  
+- **Extensible model system** for new SAM variants
+- **Comprehensive test suite** with 95% speed optimization
+
+---
+
+## 📋 Requirements
+
+- **Python 3.10+**
+- **OpenCV** for image processing
+- **PyQt6** for GUI
+- **NumPy** for data handling
+- **2.5GB** disk space for SAM model (auto-downloaded)
+
+---
+
+## 🤝 Contributing
+
+LazyLabel welcomes contributions! Check out our:
+- [Architecture Guide](src/lazylabel/ARCHITECTURE.md) for technical details
+- [Hotkey System](src/lazylabel/HOTKEY_FEATURE.md) for customization
+- Issues page for feature requests and bug reports
+
+---
+
+## 🙏 Acknowledgments
+
+LazyLabel was inspired by and builds upon the excellent work of:
+- [LabelMe](https://github.com/wkentaro/labelme) - The pioneering open-source image annotation tool
+- [Segment-Anything-UI](https://github.com/branislavhesko/segment-anything-ui) - Early SAM integration concepts
+
+---
+
+## ☕ Support
+
+If LazyLabel saves you time on annotation tasks, [consider supporting the project!](https://buymeacoffee.com/dnzckn)
+
+---
+
+**Made with ❤️ for the computer vision community**

{lazylabel_gui-1.1.5 → lazylabel_gui-1.1.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "lazylabel-gui"
-version = "1.1.5"
+version = "1.1.7"
 authors = [
   { name="Deniz N. Cakan", email="deniz.n.cakan@gmail.com" },
 ]

lazylabel_gui-1.1.7/src/lazylabel/__main__.py

@@ -0,0 +1,6 @@
+"""Allow LazyLabel to be run as a module with python -m lazylabel."""
+
+from .main import main
+
+if __name__ == "__main__":
+    main()

{lazylabel_gui-1.1.5 → lazylabel_gui-1.1.7}/src/lazylabel/config/settings.py

@@ -1,65 +1,72 @@
-"""Application settings and configuration."""
-
-import json
-import os
-from dataclasses import asdict, dataclass
-
-
-@dataclass
-class Settings:
-    """Application settings with defaults."""
-
-    # UI Settings
-    window_width: int = 1600
-    window_height: int = 900
-    left_panel_width: int = 250
-    right_panel_width: int = 350
-
-    # Annotation Settings
-    point_radius: float = 0.3
-    line_thickness: float = 0.5
-    pan_multiplier: float = 1.0
-    polygon_join_threshold: int = 2
-
-    # Model Settings
-    default_model_type: str = "vit_h"
-    default_model_filename: str = "sam_vit_h_4b8939.pth"
-
-    # Save Settings
-    auto_save: bool = True
-    save_npz: bool = True
-    save_txt: bool = True
-    save_class_aliases: bool = False
-    yolo_use_alias: bool = True
-
-    # UI State
-    annotation_size_multiplier: float = 1.0
-
-    def save_to_file(self, filepath: str) -> None:
-        """Save settings to JSON file."""
-        os.makedirs(os.path.dirname(filepath), exist_ok=True)
-        with open(filepath, "w") as f:
-            json.dump(asdict(self), f, indent=4)
-
-    @classmethod
-    def load_from_file(cls, filepath: str) -> "Settings":
-        """Load settings from JSON file."""
-        if not os.path.exists(filepath):
-            return cls()
-
-        try:
-            with open(filepath) as f:
-                data = json.load(f)
-            return cls(**data)
-        except (json.JSONDecodeError, TypeError):
-            return cls()
-
-    def update(self, **kwargs) -> None:
-        """Update settings with new values."""
-        for key, value in kwargs.items():
-            if hasattr(self, key):
-                setattr(self, key, value)
-
-
-# Default settings instance
-DEFAULT_SETTINGS = Settings()
+"""Application settings and configuration."""
+
+import json
+import os
+from dataclasses import asdict, dataclass
+
+
+@dataclass
+class Settings:
+    """Application settings with defaults."""
+
+    # UI Settings
+    window_width: int = 1600
+    window_height: int = 900
+    left_panel_width: int = 250
+    right_panel_width: int = 350
+
+    # Annotation Settings
+    point_radius: float = 0.3
+    line_thickness: float = 0.5
+    pan_multiplier: float = 1.0
+    polygon_join_threshold: int = 2
+    fragment_threshold: int = 0
+
+    # Image Adjustment Settings
+    brightness: float = 0.0
+    contrast: float = 0.0
+    gamma: float = 1.0
+
+    # Model Settings
+    default_model_type: str = "vit_h"
+    default_model_filename: str = "sam_vit_h_4b8939.pth"
+    operate_on_view: bool = False
+
+    # Save Settings
+    auto_save: bool = True
+    save_npz: bool = True
+    save_txt: bool = True
+    save_class_aliases: bool = False
+    yolo_use_alias: bool = True
+
+    # UI State
+    annotation_size_multiplier: float = 1.0
+
+    def save_to_file(self, filepath: str) -> None:
+        """Save settings to JSON file."""
+        os.makedirs(os.path.dirname(filepath), exist_ok=True)
+        with open(filepath, "w") as f:
+            json.dump(asdict(self), f, indent=4)
+
+    @classmethod
+    def load_from_file(cls, filepath: str) -> "Settings":
+        """Load settings from JSON file."""
+        if not os.path.exists(filepath):
+            return cls()
+
+        try:
+            with open(filepath) as f:
+                data = json.load(f)
+            return cls(**data)
+        except (json.JSONDecodeError, TypeError):
+            return cls()
+
+    def update(self, **kwargs) -> None:
+        """Update settings with new values."""
+        for key, value in kwargs.items():
+            if hasattr(self, key):
+                setattr(self, key, value)
+
+
+# Default settings instance
+DEFAULT_SETTINGS = Settings()