imagebaker 0.0.50__tar.gz → 0.0.53__tar.gz

{imagebaker-0.0.50 → imagebaker-0.0.53}/.gitignore

@@ -1,4 +1,5 @@
 # local files and folders
+.imagebaker
 *.json
 new_gui
 gui

imagebaker-0.0.53/CONTRIBUTING

@@ -0,0 +1,5 @@
+## Contributing Guidelines
+
+* Please add a good description of what it does.
+* If relevent, also add how it was before and how it is now after the change. Either by screenshot or by logs.
+* If updated the codebase, please run tests.

{imagebaker-0.0.50 → imagebaker-0.0.53}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: imagebaker
-Version: 0.0.50
+Version: 0.0.53
 Summary: A package for baking images.
 Home-page: https://github.com/q-viper/Image-Baker
 Author: Ramkrishna Acharya
@@ -24,7 +24,7 @@ License-File: LICENSE
 [![PyPI version](https://img.shields.io/pypi/v/imagebaker.svg)](https://pypi.org/imagebaker/)
 
 <p align="center">
-    <img src="assets/demo.gif" alt="Centered Demo" />
+    <img src="https://github.com/q-viper/image-baker/blob/main/assets/demo.gif?raw=true" alt="Centered Demo" />
 </p>
 
 
@@ -62,27 +62,28 @@ Run the following command to launch the GUI:
 
 `imagebaker`
 
-By default, the above command will not run any models on the backend. So please take a look into the example of model definition at [examples/loaded_models.py](examples/loaded_models.py). Then we need to pass it as:
+By default, the above command will not run any models on the backend. So please take a look into the example of model definition at [examples/loaded_models.py](https://github.com/q-viper/image-baker/blob/main/examples/loaded_models.py). Then we need to pass it as:
 
 `imagebaker --models-file examples/loaded_models.py`
 
 For more options, please do: `imagebaker --help` It should give the following options.
 
-![](assets/demo/options.png)
+![](https://github.com/q-viper/image-baker/blob/main/assets/demo/options.png?raw=true)
 
 
-* **`--configs-file`** allows us to define custom configs. The custom configs have to inherit LayerConfig and CanvasConfig defined at [imagebaker/core/configs/configs.py](imagebaker/core/configs/configs.py). An example is available at [examples](examples/). 
+* **`--configs-file`** allows us to define custom configs. The custom configs have to inherit LayerConfig and CanvasConfig defined at [imagebaker/core/configs/configs.py](https://github.com/q-viper/image-baker/blob/main/imagebaker/core/configs/configs.py). An example is available at [examples](https://github.com/q-viper/image-baker/blob/main/examples/). 
 
 After cloning and going to the project directory, the following code should work.
 `imagebaker --models-file examples/loaded_models.py --configs-file examples/example_config.py`
 
 ## Features
 - **Annotating Images**: Load a folder of images and annotate them using bounding boxes or polygons.
-- **Model Testing**: Define models for detection, segmentation, and prompts (e.g., points or rectangles) by following the base model structure in [imagebaker/models/base_model.py](imagebaker/models/base_model.py). See [examples/loaded_models.py](examples/loaded_models.py) for a working example.
+- **Model Testing**: Define models for detection, segmentation, and prompts (e.g., points or rectangles) by following the base model structure in [imagebaker/models/base_model.py](https://github.com/q-viper/image-baker/blob/main/imagebaker/models/base_model.py). See [examples/loaded_models.py](https://github.com/q-viper/image-baker/blob/main/examples/loaded_models.py) for a working example.
 - **Layerifying**: Crop images based on annotations to create reusable layers. Each cropped image represents a single layer.
 - **Baking States**: Arrange layers to create image variations by dragging, rotating, adjusting opacity, and more. Save the state using the Save State button or Ctrl + S.
 - **Playing States**: Replay saved states, export them locally, or use them for further predictions.
 - **Exporting States**: Export the final annotated JSON and the baked multilayer image.
+- **Drawing On Layers**: First select a layer then draw upon it. Only selected layer will be drawn. And if no layers are selected, then the drawing will not be exported.
 
 ### Shortcuts
 * **Ctrl + C**: Copy selected annotation/layer.
@@ -91,34 +92,44 @@ After cloning and going to the project directory, the following code should work
 * **Left Click**: Select an annotation/layer on mouse position.
 * **Left Click + Drag**: Drag a selected annotation/layer.
 * **Double Left Click**: When using polygon annotation, completes the polygon.
-* **Right Click**: Deselect an annotation/layer. While annotating the polygon, undo the last point.
+* **Right Click**: Unselect an annotation/layer. While annotating the polygon, undo the last point.
 * **Ctrl + Mouse Wheel**: Zoom In/Out on the mouse position, i.e., resize the viewport.
 * **Ctrl + Drag**: If done on the background, the viewport is panned.
 * **Ctrl + S**: Save State on Baker Tab.
 * **Ctrl + D**: Draw Mode on Baker Tab. Drawing can happen on a selected or main layer.
 * **Ctrl + E**: Erase Mode on Baker Tab.
+* **Ctrl + H**: Opens a help window.
 * **Wheel**: Change the size of the drawing pointer.
+* **Q**: Point mode on annotation.
+* **W**: Polygon mode on annotation. Moves selected layer one step up in layer lists in baker.
+* **S**: Moves selected layer one step down in layer list in baker.
+* **E**: Rectangle mode on annotation.
+* **H**: Hides/un-hides selected annotation/layer.
+* **L**: Creates layer from an annotation. If any annotation selected, creates only its, else creates layers from all visible annotations.
+* **C**: If any annotation is selected, a input box for Caption is created. It can be edited on baker tab as well and is state aware.
+* **Numerics**: Selecting number 1, 2, till 9 selects label. If not available, asks for a new label.
+* **Escape**: Closes the application.
 
 ## Demo
 ### Annotation Page
 This is where the loading of the image folder and annotation, connection with the model running in the backend, and layerifying happen.
 
-![](assets/demo/annotation_page.png)
+![](https://github.com/q-viper/image-baker/blob/main/assets/demo/annotation_page.png?raw=True)
 
 ### Baker Page
 This is where the layer baking happens. And the extraction of the layers as well.
 
-![](assets/demo/baker_page.png)
+![](https://github.com/q-viper/image-baker/blob/main/assets/demo/baker_page.png?raw=True)
 
 An example of drawing:
 
-![](assets/demo/drawing.png)
+![](https://github.com/q-viper/image-baker/blob/main/assets/demo/drawing.png?raw=True)
 
 ### Annotated
 
 The JSON and the baked image will be exported to the local folder, and in debug mode, the annotations and the mask for each layer will be exported too.
 
-![](assets/demo/annotated_veg_smiley.png)
+![](https://github.com/q-viper/image-baker/blob/main/assets/demo/annotated_veg_smiley.png?raw=True)
 
 ### Demo Video
 
@@ -137,3 +148,5 @@ Click on the image above to play the video on YouTube.
 Contributions are welcome! 
 
 Do you find this project to be useful and are you looking for some features that are not implemented yet? Feel free to open issues or submit pull requests to improve the project.
+
+For more please visit [CONTRIBUTING](CONTRIBUTING).

{imagebaker-0.0.50 → imagebaker-0.0.53}/README.md

@@ -8,7 +8,7 @@
 [![PyPI version](https://img.shields.io/pypi/v/imagebaker.svg)](https://pypi.org/imagebaker/)
 
 <p align="center">
-    <img src="assets/demo.gif" alt="Centered Demo" />
+    <img src="https://github.com/q-viper/image-baker/blob/main/assets/demo.gif?raw=true" alt="Centered Demo" />
 </p>
 
 
@@ -46,27 +46,28 @@ Run the following command to launch the GUI:
 
 `imagebaker`
 
-By default, the above command will not run any models on the backend. So please take a look into the example of model definition at [examples/loaded_models.py](examples/loaded_models.py). Then we need to pass it as:
+By default, the above command will not run any models on the backend. So please take a look into the example of model definition at [examples/loaded_models.py](https://github.com/q-viper/image-baker/blob/main/examples/loaded_models.py). Then we need to pass it as:
 
 `imagebaker --models-file examples/loaded_models.py`
 
 For more options, please do: `imagebaker --help` It should give the following options.
 
-![](assets/demo/options.png)
+![](https://github.com/q-viper/image-baker/blob/main/assets/demo/options.png?raw=true)
 
 
-* **`--configs-file`** allows us to define custom configs. The custom configs have to inherit LayerConfig and CanvasConfig defined at [imagebaker/core/configs/configs.py](imagebaker/core/configs/configs.py). An example is available at [examples](examples/). 
+* **`--configs-file`** allows us to define custom configs. The custom configs have to inherit LayerConfig and CanvasConfig defined at [imagebaker/core/configs/configs.py](https://github.com/q-viper/image-baker/blob/main/imagebaker/core/configs/configs.py). An example is available at [examples](https://github.com/q-viper/image-baker/blob/main/examples/). 
 
 After cloning and going to the project directory, the following code should work.
 `imagebaker --models-file examples/loaded_models.py --configs-file examples/example_config.py`
 
 ## Features
 - **Annotating Images**: Load a folder of images and annotate them using bounding boxes or polygons.
-- **Model Testing**: Define models for detection, segmentation, and prompts (e.g., points or rectangles) by following the base model structure in [imagebaker/models/base_model.py](imagebaker/models/base_model.py). See [examples/loaded_models.py](examples/loaded_models.py) for a working example.
+- **Model Testing**: Define models for detection, segmentation, and prompts (e.g., points or rectangles) by following the base model structure in [imagebaker/models/base_model.py](https://github.com/q-viper/image-baker/blob/main/imagebaker/models/base_model.py). See [examples/loaded_models.py](https://github.com/q-viper/image-baker/blob/main/examples/loaded_models.py) for a working example.
 - **Layerifying**: Crop images based on annotations to create reusable layers. Each cropped image represents a single layer.
 - **Baking States**: Arrange layers to create image variations by dragging, rotating, adjusting opacity, and more. Save the state using the Save State button or Ctrl + S.
 - **Playing States**: Replay saved states, export them locally, or use them for further predictions.
 - **Exporting States**: Export the final annotated JSON and the baked multilayer image.
+- **Drawing On Layers**: First select a layer then draw upon it. Only selected layer will be drawn. And if no layers are selected, then the drawing will not be exported.
 
 ### Shortcuts
 * **Ctrl + C**: Copy selected annotation/layer.
@@ -75,34 +76,44 @@ After cloning and going to the project directory, the following code should work
 * **Left Click**: Select an annotation/layer on mouse position.
 * **Left Click + Drag**: Drag a selected annotation/layer.
 * **Double Left Click**: When using polygon annotation, completes the polygon.
-* **Right Click**: Deselect an annotation/layer. While annotating the polygon, undo the last point.
+* **Right Click**: Unselect an annotation/layer. While annotating the polygon, undo the last point.
 * **Ctrl + Mouse Wheel**: Zoom In/Out on the mouse position, i.e., resize the viewport.
 * **Ctrl + Drag**: If done on the background, the viewport is panned.
 * **Ctrl + S**: Save State on Baker Tab.
 * **Ctrl + D**: Draw Mode on Baker Tab. Drawing can happen on a selected or main layer.
 * **Ctrl + E**: Erase Mode on Baker Tab.
+* **Ctrl + H**: Opens a help window.
 * **Wheel**: Change the size of the drawing pointer.
+* **Q**: Point mode on annotation.
+* **W**: Polygon mode on annotation. Moves selected layer one step up in layer lists in baker.
+* **S**: Moves selected layer one step down in layer list in baker.
+* **E**: Rectangle mode on annotation.
+* **H**: Hides/un-hides selected annotation/layer.
+* **L**: Creates layer from an annotation. If any annotation selected, creates only its, else creates layers from all visible annotations.
+* **C**: If any annotation is selected, a input box for Caption is created. It can be edited on baker tab as well and is state aware.
+* **Numerics**: Selecting number 1, 2, till 9 selects label. If not available, asks for a new label.
+* **Escape**: Closes the application.
 
 ## Demo
 ### Annotation Page
 This is where the loading of the image folder and annotation, connection with the model running in the backend, and layerifying happen.
 
-![](assets/demo/annotation_page.png)
+![](https://github.com/q-viper/image-baker/blob/main/assets/demo/annotation_page.png?raw=True)
 
 ### Baker Page
 This is where the layer baking happens. And the extraction of the layers as well.
 
-![](assets/demo/baker_page.png)
+![](https://github.com/q-viper/image-baker/blob/main/assets/demo/baker_page.png?raw=True)
 
 An example of drawing:
 
-![](assets/demo/drawing.png)
+![](https://github.com/q-viper/image-baker/blob/main/assets/demo/drawing.png?raw=True)
 
 ### Annotated
 
 The JSON and the baked image will be exported to the local folder, and in debug mode, the annotations and the mask for each layer will be exported too.
 
-![](assets/demo/annotated_veg_smiley.png)
+![](https://github.com/q-viper/image-baker/blob/main/assets/demo/annotated_veg_smiley.png?raw=True)
 
 ### Demo Video
 
@@ -120,4 +131,6 @@ Click on the image above to play the video on YouTube.
 
 Contributions are welcome! 
 
-Do you find this project to be useful and are you looking for some features that are not implemented yet? Feel free to open issues or submit pull requests to improve the project.
+Do you find this project to be useful and are you looking for some features that are not implemented yet? Feel free to open issues or submit pull requests to improve the project.
+
+For more please visit [CONTRIBUTING](CONTRIBUTING).

imagebaker-0.0.53/docs/index.md

@@ -0,0 +1,136 @@
+# Image-Baker
+![Dependabot Status](https://img.shields.io/badge/dependabot-active-brightgreen)
+![GitHub License](https://img.shields.io/github/license/q-viper/image-baker)
+![commit activity](https://img.shields.io/github/commit-activity/w/q-viper/SmokeSim/master)
+![code size in bytes](https://img.shields.io/github/languages/code-size/q-viper/image-baker)
+<!-- ![Tests](https://github.com/q-viper/SmokeSim/actions/workflows/test-on-push.yml/badge.svg) -->
+![Code Formatting](https://github.com/q-viper/image-baker/actions/workflows/black-formatter.yml/badge.svg)
+[![PyPI version](https://img.shields.io/pypi/v/imagebaker.svg)](https://pypi.org/imagebaker/)
+
+<p align="center">
+    <img src="https://github.com/q-viper/image-baker/blob/main/assets/demo.gif?raw=true" alt="Centered Demo" />
+</p>
+
+
+*An example of baked images. (Each object is a layer and an annotation will also be extracted for all layers.)*
+
+Let's bake an image.
+
+## Why is it relevant?
+
+When training computer vision models (especially for detection and segmentation), labeling large amounts of data is crucial for better model performance. Often, the process involves multiple cycles of labeling, training, and evaluation. By generating multiple realistic labeled datasets from a single image, the time spent on labeling can be significantly reduced.
+
+## What's up with the name?
+The concept involves extracting portions of an image (e.g., objects of interest) using tools like polygons or models such as Segment Anything. These extractions are treated as layers, which can then be copied, pasted, and manipulated to create multiple instances of the desired object. By combining these layers step by step, a new labeled image with annotations in JSON format is created. The term "baking" refers to the process of merging these layers into a single cohesive image.
+
+## Getting Started
+### Installation
+#### Using PIP
+This project is also available on the PyPI server.
+
+```bash
+pip install imagebaker
+```
+
+#### Developing
+Please, clone this repository and install it locally:
+
+```bash
+git clone https://github.com/q-viper/image-baker.git 
+cd image-baker
+pip install -e .
+```
+
+### First Run
+Run the following command to launch the GUI:
+
+`imagebaker`
+
+By default, the above command will not run any models on the backend. So please take a look into the example of model definition at [examples/loaded_models.py](https://github.com/q-viper/image-baker/blob/main/examples/loaded_models.py). Then we need to pass it as:
+
+`imagebaker --models-file examples/loaded_models.py`
+
+For more options, please do: `imagebaker --help` It should give the following options.
+
+![](https://github.com/q-viper/image-baker/blob/main/assets/demo/options.png?raw=true)
+
+
+* **`--configs-file`** allows us to define custom configs. The custom configs have to inherit LayerConfig and CanvasConfig defined at [imagebaker/core/configs/configs.py](https://github.com/q-viper/image-baker/blob/main/imagebaker/core/configs/configs.py). An example is available at [examples](https://github.com/q-viper/image-baker/blob/main/examples/). 
+
+After cloning and going to the project directory, the following code should work.
+`imagebaker --models-file examples/loaded_models.py --configs-file examples/example_config.py`
+
+## Features
+- **Annotating Images**: Load a folder of images and annotate them using bounding boxes or polygons.
+- **Model Testing**: Define models for detection, segmentation, and prompts (e.g., points or rectangles) by following the base model structure in [imagebaker/models/base_model.py](https://github.com/q-viper/image-baker/blob/main/imagebaker/models/base_model.py). See [examples/loaded_models.py](https://github.com/q-viper/image-baker/blob/main/examples/loaded_models.py) for a working example.
+- **Layerifying**: Crop images based on annotations to create reusable layers. Each cropped image represents a single layer.
+- **Baking States**: Arrange layers to create image variations by dragging, rotating, adjusting opacity, and more. Save the state using the Save State button or Ctrl + S.
+- **Playing States**: Replay saved states, export them locally, or use them for further predictions.
+- **Exporting States**: Export the final annotated JSON and the baked multilayer image.
+- **Drawing On Layers**: First select a layer then draw upon it. Only selected layer will be drawn. And if no layers are selected, then the drawing will not be exported.
+
+### Shortcuts
+* **Ctrl + C**: Copy selected annotation/layer.
+* **Ctrl + V**: Paste copied annotation/layer in its parent image/layer if it is currently open.
+* **Delete**: Delete selected annotation/layer.
+* **Left Click**: Select an annotation/layer on mouse position.
+* **Left Click + Drag**: Drag a selected annotation/layer.
+* **Double Left Click**: When using polygon annotation, completes the polygon.
+* **Right Click**: Unselect an annotation/layer. While annotating the polygon, undo the last point.
+* **Ctrl + Mouse Wheel**: Zoom In/Out on the mouse position, i.e., resize the viewport.
+* **Ctrl + Drag**: If done on the background, the viewport is panned.
+* **Ctrl + S**: Save State on Baker Tab.
+* **Ctrl + D**: Draw Mode on Baker Tab. Drawing can happen on a selected or main layer.
+* **Ctrl + E**: Erase Mode on Baker Tab.
+* **Ctrl + H**: Opens a help window.
+* **Wheel**: Change the size of the drawing pointer.
+* **Q**: Point mode on annotation.
+* **W**: Polygon mode on annotation. Moves selected layer one step up in layer lists in baker.
+* **S**: Moves selected layer one step down in layer list in baker.
+* **E**: Rectangle mode on annotation.
+* **H**: Hides/un-hides selected annotation/layer.
+* **L**: Creates layer from an annotation. If any annotation selected, creates only its, else creates layers from all visible annotations.
+* **C**: If any annotation is selected, a input box for Caption is created. It can be edited on baker tab as well and is state aware.
+* **Numerics**: Selecting number 1, 2, till 9 selects label. If not available, asks for a new label.
+* **Escape**: Closes the application.
+
+## Demo
+### Annotation Page
+This is where the loading of the image folder and annotation, connection with the model running in the backend, and layerifying happen.
+
+![](https://github.com/q-viper/image-baker/blob/main/assets/demo/annotation_page.png?raw=True)
+
+### Baker Page
+This is where the layer baking happens. And the extraction of the layers as well.
+
+![](https://github.com/q-viper/image-baker/blob/main/assets/demo/baker_page.png?raw=True)
+
+An example of drawing:
+
+![](https://github.com/q-viper/image-baker/blob/main/assets/demo/drawing.png?raw=True)
+
+### Annotated
+
+The JSON and the baked image will be exported to the local folder, and in debug mode, the annotations and the mask for each layer will be exported too.
+
+![](https://github.com/q-viper/image-baker/blob/main/assets/demo/annotated_veg_smiley.png?raw=True)
+
+### Demo Video
+
+To see the tool in action, check out the demo video below:
+
+
+[![Demo Video](https://img.youtube.com/vi/WckMT0r-2Lc/0.jpg)](https://youtu.be/WckMT0r-2Lc)
+
+
+Click on the image above to play the video on YouTube.
+
+
+## Contributions
+
+
+Contributions are welcome! 
+
+Do you find this project to be useful and are you looking for some features that are not implemented yet? Feel free to open issues or submit pull requests to improve the project.
+
+For more please visit [CONTRIBUTING](CONTRIBUTING).

{imagebaker-0.0.50 → imagebaker-0.0.53}/examples/loaded_models.py

@@ -14,13 +14,13 @@ from imagebaker.models.base_model import BaseDetectionModel
 from imagebaker import logger
 
 # Import models from the examples folder
-# from examples.rtdetr_v2 import RTDetrModelConfig, RTDetrDetectionModel
-# from examples.segmentation import (
-#     YoloSegmentationModel,
-#     YoloSegmentationModelConfig,
-# )
+from examples.rtdetr_v2 import RTDetrModelConfig, RTDetrDetectionModel
+from examples.segmentation import (
+    YoloSegmentationModel,
+    YoloSegmentationModelConfig,
+)
 
-# from examples.sam_model import SegmentAnythingModel, SAMModelConfig
+from examples.sam_model import SegmentAnythingModel, SAMModelConfig
 
 
 class ClassificationModel(BaseClassificationModel):
@@ -40,22 +40,22 @@ class DetectionModel(BaseDetectionModel):
 
 
 return_annotated_image = True
-# detector = RTDetrDetectionModel(
-#     RTDetrModelConfig(return_annotated_image=return_annotated_image)
-# )
-
-# classification = ClassificationModel(
-#     DefaultModelConfig(
-#         model_type=ModelType.CLASSIFICATION,
-#         return_annotated_image=return_annotated_image,
-#     )
-# )
-# segmentation = YoloSegmentationModel(
-#     YoloSegmentationModelConfig(return_annotated_image=return_annotated_image)
-# )
-# prompt = SegmentAnythingModel(
-#     SAMModelConfig(return_annotated_image=return_annotated_image)
-# )
+detector = RTDetrDetectionModel(
+    RTDetrModelConfig(return_annotated_image=return_annotated_image)
+)
+
+classification = ClassificationModel(
+    DefaultModelConfig(
+        model_type=ModelType.CLASSIFICATION,
+        return_annotated_image=return_annotated_image,
+    )
+)
+segmentation = YoloSegmentationModel(
+    YoloSegmentationModelConfig(return_annotated_image=return_annotated_image)
+)
+prompt = SegmentAnythingModel(
+    SAMModelConfig(return_annotated_image=return_annotated_image)
+)
 dummy_detector = DetectionModel(
     DefaultModelConfig(
         model_type=ModelType.DETECTION, return_annotated_image=return_annotated_image
@@ -65,10 +65,10 @@ dummy_detector = DetectionModel(
 
 LOADED_MODELS = {
     "DummyDetectionModel": dummy_detector,
-    # "PromptModel": prompt,
-    # "SegmentationModel": segmentation,
-    # "RTDetrV2": detector,
-    # "ClassificationModel": classification,
+    "PromptModel": prompt,
+    "SegmentationModel": segmentation,
+    "RTDetrV2": detector,
+    "ClassificationModel": classification,
 }
 
 logger.info(f"Loaded models: {LOADED_MODELS}")

{imagebaker-0.0.50 → imagebaker-0.0.53}/imagebaker/core/configs/configs.py

@@ -74,6 +74,22 @@ class BaseConfig(BaseModel):
             logger.info(f"Created assets folder at {asset_dir}")
         return asset_dir
 
+    @property
+    def cache_dir(self):
+        cache_dir = self.project_dir / ".imagebaker" / "cache"
+        if not cache_dir.exists():
+            cache_dir.mkdir(parents=True)
+            logger.info(f"Created cache folder at {cache_dir}")
+        return cache_dir
+
+    @property
+    def bake_dir(self):
+        bake_dir = self.project_dir / ".imagebaker" / "bake"
+        if not bake_dir.exists():
+            bake_dir.mkdir(parents=True)
+            logger.info(f"Created bake folder at {bake_dir}")
+        return bake_dir
+
     class Config:
         arbitrary_types_allowed = True
 
@@ -96,6 +112,7 @@ class LayerConfig(BaseConfig):
     )
     # whether to search image in subfolders as well
     full_search: bool = False
+    cleanup_on_exit: bool = False
 
     def get_label_color(self, label):
         for lbl in self.predefined_labels:

{imagebaker-0.0.50 → imagebaker-0.0.53}/imagebaker/core/defs/defs.py

@@ -78,6 +78,7 @@ class LayerState:
     drawing_states: list[DrawingState] = field(default_factory=list)
     edge_opacity: int = 100
     edge_width: int = 10
+    caption: str = ""
 
     def copy(self):
         return LayerState(
@@ -109,6 +110,7 @@ class LayerState:
             ],
             edge_opacity=self.edge_opacity,
             edge_width=self.edge_width,
+            caption=self.caption,
         )
 
 
@@ -138,6 +140,7 @@ class Annotation:
     file_path: Path = field(default_factory=lambda: Path("Runtime"))
     is_model_generated: bool = False
     model_name: str = None
+    caption: str = ""
 
     def copy(self):
         ann = Annotation(
@@ -156,6 +159,7 @@ class Annotation:
             file_path=self.file_path,
             is_model_generated=self.is_model_generated,
             model_name=self.model_name,
+            caption=self.caption,
         )
         ann.is_selected = False
         return ann
@@ -200,6 +204,7 @@ class Annotation:
                 "file_path": str(annotation.file_path),
                 "is_model_generated": annotation.is_model_generated,
                 "model_name": annotation.model_name,
+                "caption": annotation.caption,
             }
             annotations_dict.append(data)
 
@@ -210,6 +215,10 @@ class Annotation:
     def load_from_json(path: str):
         import json
 
+        # if path does not exist, return empty list
+        if not Path(path).exists():
+            return []
+
         with open(path, "r") as f:
             data = json.load(f)
 
@@ -230,6 +239,7 @@ class Annotation:
                 file_path=Path(d.get("file_path", "Runtime")),
                 is_model_generated=d.get("is_model_generated", False),
                 model_name=d.get("model_name", None),
+                caption=d.get("caption", ""),
             )
 
             # Handle points safely