supervisely 6.73.408__tar.gz → 6.73.410__tar.gz

{supervisely-6.73.408/supervisely.egg-info → supervisely-6.73.410}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: supervisely
-Version: 6.73.408
+Version: 6.73.410
 Summary: Supervisely Python SDK.
 Home-page: https://github.com/supervisely/supervisely
 Author: Supervisely

{supervisely-6.73.408 → supervisely-6.73.410}/supervisely/__init__.py

@@ -312,7 +312,9 @@ try:
 except Exception as e:
     logger.warn(f"Failed to setup certificates. Reason: {repr(e)}", exc_info=True)
 
-# If new changes in Supervisely Python SDK require upgrade of the Supervisely instance
-# set a new value for the environment variable MINIMUM_INSTANCE_VERSION_FOR_SDK, otherwise
-# users can face compatibility issues, if the instance version is lower than the SDK version.
-os.environ["MINIMUM_INSTANCE_VERSION_FOR_SDK"] = "6.14.00"
+# Configure minimum instance version automatically from versions.json
+# if new changes in Supervisely Python SDK require upgrade of the Supervisely instance.
+# If the instance version is lower than the SDK version, users can face compatibility issues.
+from supervisely.io.env import configure_minimum_instance_version
+
+configure_minimum_instance_version()

{supervisely-6.73.408 → supervisely-6.73.410}/supervisely/_utils.py

@@ -597,3 +597,42 @@ def remove_non_printable(text: str) -> str:
     :rtype: str
     """
     return "".join(char for char in text if char.isprintable()).strip()
+
+
+def get_latest_instance_version_from_json() -> Optional[str]:
+    """
+    Get the latest (last) instance version from versions.json file.
+
+    The versions.json file should contain a mapping of SDK versions to instance versions.
+    This function returns the instance version from the last entry in the file.
+
+    :return: Latest instance version or None if not found
+    :rtype: Optional[str]
+    """
+    import json
+
+    try:
+        # Get the path to versions.json relative to this file
+        current_dir = os.path.dirname(os.path.abspath(__file__))
+        versions_file = os.path.join(current_dir, "versions.json")
+
+        if not os.path.exists(versions_file):
+            logger.debug(f"versions.json file not found at {versions_file}")
+            return None
+
+        with open(versions_file, "r", encoding="utf-8") as f:
+            versions_mapping = json.load(f)
+
+        if not versions_mapping:
+            return None
+
+        # Get the last (latest) entry from the versions mapping
+        # Since JSON preserves order in Python 3.7+, the last item is the latest
+        latest_instance_version = list(versions_mapping.keys())[-1]
+        logger.debug(f"Latest instance version found: {latest_instance_version}")
+        return latest_instance_version
+
+    except Exception:
+        # Silently fail - don't break the import if versions.json is missing or malformed
+        logger.debug("Failed to get latest instance version from versions.json")
+        return None

{supervisely-6.73.408 → supervisely-6.73.410}/supervisely/api/module_api.py

@@ -695,6 +695,14 @@ class ApiField:
     """"""
     REMOTE_ENTITIES_COUNT = "remoteEntitiesCount"
     """"""
+    RESTRICTED_IMAGE_IDS = "restrictedImageIds"
+    """"""
+    NUMBER_OF_CLUSTERS = "numberOfClusters"
+    """"""
+    CLUSTERING_METHOD = "clusteringMethod"
+    """"""
+    ERROR_MESSAGE = "errorMessage"
+    """"""
 
 
 def _get_single_item(items):

{supervisely-6.73.408 → supervisely-6.73.410}/supervisely/api/project_api.py

@@ -215,6 +215,39 @@ class ProjectApi(CloneableModuleApi, UpdateableModule, RemoveableModuleApi):
             ApiField.REMOTE_ENTITIES_COUNT,
         ]
 
+    @staticmethod
+    def info_sequence_for_listing():
+        """
+        NamedTuple ProjectInfo fields available for listing operations.
+
+        This subset includes only fields that are available in the `projects.list` API endpoint.
+        For complete project information, use `get_info_by_id()`.
+
+        :return: List of API field names available for listing
+        :rtype: List[str]
+        """
+        return [
+            ApiField.ID,
+            ApiField.NAME,
+            ApiField.DESCRIPTION,
+            ApiField.SIZE,
+            ApiField.README,
+            ApiField.WORKSPACE_ID,
+            ApiField.IMAGES_COUNT,  # for compatibility with existing code
+            ApiField.DATASETS_COUNT,
+            ApiField.CREATED_AT,
+            ApiField.UPDATED_AT,
+            ApiField.TYPE,
+            ApiField.REFERENCE_IMAGE_URL,
+            ApiField.CUSTOM_DATA,
+            ApiField.BACKUP_ARCHIVE,
+            ApiField.TEAM_ID,
+            ApiField.IMPORT_SETTINGS,
+            ApiField.EMBEDDINGS_ENABLED,
+            ApiField.EMBEDDINGS_UPDATED_AT,
+            ApiField.EMBEDDINGS_IN_PROGRESS,
+        ]
+
     @staticmethod
     def info_tuple_name():
         """
@@ -347,7 +380,7 @@ class ProjectApi(CloneableModuleApi, UpdateableModule, RemoveableModuleApi):
         id: int,
         expected_type: Optional[str] = None,
         raise_error: bool = False,
-        extra_fields: Optional[List[str]] = None
+        extra_fields: Optional[List[str]] = None,
     ) -> ProjectInfo:
         """
         Get Project information by ID.
@@ -457,21 +490,24 @@ class ProjectApi(CloneableModuleApi, UpdateableModule, RemoveableModuleApi):
             #                     import_settings={}
             #                   )
         """
-
-        fields = [
-            x
-            for x in self.info_sequence()
-            if x
-            not in (
-                ApiField.ITEMS_COUNT,
-                ApiField.SETTINGS,
-                ApiField.CREATED_BY_ID,
-                ApiField.LOCAL_ENTITIES_COUNT,
-                ApiField.REMOTE_ENTITIES_COUNT,
+        try:
+            fields = self.info_sequence_for_listing()
+            info = super().get_info_by_name(parent_id, name, fields)
+        except Exception as e:
+            logger.trace(
+                f"Failed to get info by name with all available fields for 'projects.list' endpoint: {e} "
+                "Falling back to minimal fields (id) and get_info_by_id()."
             )
-        ]
-
-        info = super().get_info_by_name(parent_id, name, fields)
+            fields = [ApiField.ID]
+            info = super().get_info_by_name(parent_id, name, fields)
+            if info is None:
+                if raise_error:
+                    raise ProjectNotFound(
+                        f"Project with name {name!r} not found in workspace {parent_id!r}."
+                    )
+                else:
+                    return None
+            info = self.get_info_by_id(info.id)
         self._check_project_info(
             info, name=name, expected_type=expected_type, raise_error=raise_error
         )
@@ -2213,7 +2249,21 @@ class ProjectApi(CloneableModuleApi, UpdateableModule, RemoveableModuleApi):
             {ApiField.ID: id, ApiField.EMBEDDINGS_ENABLED: False, ApiField.SILENT: silent},
         )
 
-    def set_embeddings_in_progress(self, id: int, in_progress: bool) -> None:
+    def is_embeddings_enabled(self, id: int) -> bool:
+        """
+        Check if embeddings are enabled for the project.
+
+        :param id: Project ID
+        :type id: int
+        :return: True if embeddings are enabled, False otherwise.
+        :rtype: bool
+        """
+        info = self.get_info_by_id(id, extra_fields=[ApiField.EMBEDDINGS_ENABLED])
+        return info.embeddings_enabled
+
+    def set_embeddings_in_progress(
+        self, id: int, in_progress: bool, error_message: Optional[str] = None
+    ) -> None:
         """
         Set embeddings in progress status for the project.
         This method is used to indicate whether embeddings are currently being created for the project.
@@ -2222,13 +2272,34 @@ class ProjectApi(CloneableModuleApi, UpdateableModule, RemoveableModuleApi):
         :type id: int
         :param in_progress: Status to set. If True, embeddings are in progress right now.
         :type in_progress: bool
+        :param error_message: Optional error message to provide additional context.
+        :type error_message: Optional[str]
         :return: None
         :rtype: :class:`NoneType`
         """
-        self._api.post(
-            "projects.embeddings-in-progress.update",
-            {ApiField.ID: id, ApiField.EMBEDDINGS_IN_PROGRESS: in_progress},
-        )
+        data = {ApiField.ID: id, ApiField.EMBEDDINGS_IN_PROGRESS: in_progress}
+        if error_message is not None:
+            data[ApiField.ERROR_MESSAGE] = error_message
+        self._api.post("projects.embeddings-in-progress.update", data)
+
+    def get_embeddings_in_progress(self, id: int) -> bool:
+        """
+        Get the embeddings in progress status for the project.
+        This method checks whether embeddings are currently being created for the project.
+
+        :param id: Project ID
+        :type id: int
+        :return: True if embeddings are in progress, False otherwise.
+        :rtype: bool
+        """
+        info = self.get_info_by_id(id, extra_fields=[ApiField.EMBEDDINGS_IN_PROGRESS])
+        if info is None:
+            raise RuntimeError(f"Project with ID {id} not found.")
+        if not hasattr(info, "embeddings_in_progress"):
+            raise RuntimeError(
+                f"Project with ID {id} does not have 'embeddings_in_progress' field in its info."
+            )
+        return info.embeddings_in_progress
 
     def set_embeddings_updated_at(
         self, id: int, timestamp: Optional[str] = None, silent: bool = True
@@ -2267,14 +2338,46 @@ class ProjectApi(CloneableModuleApi, UpdateableModule, RemoveableModuleApi):
             {ApiField.ID: id, ApiField.EMBEDDINGS_UPDATED_AT: timestamp, ApiField.SILENT: silent},
         )
 
+    def get_embeddings_updated_at(self, id: int) -> Optional[str]:
+        """
+        Get the timestamp when embeddings were last updated for the project.
+
+        :param id: Project ID
+        :type id: int
+        :return: ISO format timestamp (YYYY-MM-DDTHH:MM:SS.fffZ) or None if not set.
+        :rtype: Optional[str]
+        :Usage example:
+
+         .. code-block:: python
+
+            api = sly.Api.from_env()
+            project_id = 123
+
+            # Get embeddings updated timestamp
+            updated_at = api.project.get_embeddings_updated_at(project_id)
+            print(updated_at)  # Output: "2025-06-01T10:30:45.123Z" or None
+        """
+        info = self.get_info_by_id(id, extra_fields=[ApiField.EMBEDDINGS_UPDATED_AT])
+        if info is None:
+            raise RuntimeError(f"Project with ID {id} not found.")
+        if not hasattr(info, "embeddings_updated_at"):
+            raise RuntimeError(
+                f"Project with ID {id} does not have 'embeddings_updated_at' field in its info."
+            )
+        return info.embeddings_updated_at
+
     def perform_ai_search(
         self,
         project_id: int,
         dataset_id: Optional[int] = None,
-        image_id: Optional[int] = None,
+        image_id: Optional[Union[int, List[int]]] = None,
         prompt: Optional[str] = None,
         method: Optional[Literal["centroids", "random"]] = None,
         limit: int = 100,
+        clustering_method: Optional[Literal["kmeans", "dbscan"]] = None,
+        num_clusters: Optional[int] = None,
+        image_id_scope: Optional[List[int]] = None,
+        threshold: Optional[float] = None,
     ) -> Optional[int]:
         """
         Send AI search request to initiate search process.
@@ -2285,14 +2388,22 @@ class ProjectApi(CloneableModuleApi, UpdateableModule, RemoveableModuleApi):
         :type project_id: int
         :param dataset_id: ID of the Dataset. If not None - search will be limited to this dataset.
         :type dataset_id: Optional[int]
-        :param image_id: ID of the Image. Searches for images similar to the specified image.
-        :type image_id: Optional[int]
+        :param image_id: ID(s) of the Image(s). Searches for images similar to the specified image(s).
+        :type image_id: Optional[Union[int, List[int]]]
         :param prompt: Text prompt for search request. Searches for similar images based on a text description.
         :type prompt: Optional[str]
         :param method: Activates diverse search using one of the following methods: "centroids", "random".
         :type method: Optional[Literal["centroids", "random"]]
         :param limit: Limit for search request
         :type limit: int
+        :param clustering_method: Method for clustering results. Can be "kmeans" or "dbscan". If None, no clustering is applied.
+        :type clustering_method: Optional[Literal["kmeans", "dbscan"]]
+        :param num_clusters: Number of clusters to create if clustering_method is specified. Required for "kmeans" method.
+        :type num_clusters: Optional[int]
+        :param image_id_scope: List of image IDs to limit the search scope. If None, the search will be performed across all images in the project if other filters are not set.
+        :type image_id_scope: Optional[List[int]]
+        :param threshold: Threshold for similarity. If provided, only images with similarity above this threshold will be returned.
+        :type threshold: Optional[float]
         :return: Entitites Collection ID of the search results, or None if no collection was created.
         :rtype: Optional[int]
         :raises ValueError: only one of `prompt`, `image_id` or `method`must be provided, and `method` must be one of the allowed values.
@@ -2349,15 +2460,45 @@ class ProjectApi(CloneableModuleApi, UpdateableModule, RemoveableModuleApi):
         if dataset_id is not None:
             request_body[ApiField.DATASET_ID] = dataset_id
 
-        if image_id is not None:
-            request_body[ApiField.IMAGE_ID] = image_id
-
         if prompt is not None:
             request_body[ApiField.PROMPT] = prompt
 
+        if image_id is not None:
+            if prompt is not None or method is not None:
+                raise ValueError("If 'image_id' is provided, 'prompt' and 'method' must be None.")
+            if isinstance(image_id, int):
+                image_id = [image_id]
+            if not isinstance(image_id, list):
+                raise ValueError("image_id must be a list of image IDs.")
+            request_body[ApiField.IMAGE_IDS] = image_id
+
         if method is not None:
+            if image_id is not None or prompt is not None:
+                raise ValueError("If 'method' is provided, 'image_id' and 'prompt' must be None.")
             request_body[ApiField.METHOD] = method
 
+        if clustering_method is not None:
+            if clustering_method not in ["kmeans", "dbscan"]:
+                raise ValueError("Clustering method must be either 'kmeans' or 'dbscan'.")
+            request_body[ApiField.CLUSTERING_METHOD] = clustering_method
+
+        if num_clusters is not None:
+            if clustering_method != "kmeans":
+                raise ValueError(
+                    "Number of clusters is only applicable for 'kmeans' clustering method."
+                )
+            request_body[ApiField.NUMBER_OF_CLUSTERS] = num_clusters
+
+        if image_id_scope is not None:
+            if not isinstance(image_id_scope, list):
+                raise ValueError("image_id_scope must be a list of image IDs.")
+            request_body[ApiField.RESTRICTED_IMAGE_IDS] = image_id_scope
+
+        if threshold is not None:
+            if not isinstance(threshold, (int, float)):
+                raise ValueError("Threshold must be a number.")
+            request_body[ApiField.THRESHOLD] = threshold
+
         response = self._api.post("embeddings.send-ai-search", request_body)
         return response.json().get(ApiField.COLLECTION_ID, None)
 
@@ -2366,6 +2507,8 @@ class ProjectApi(CloneableModuleApi, UpdateableModule, RemoveableModuleApi):
         Calculate embeddings for the project.
         This method is used to calculate embeddings for all images in the project.
 
+        To check status of embeddings calculation, use :meth:`get_embeddings_in_progress`
+
         :param id: Project ID
         :type id: int
         :return: None

{supervisely-6.73.408 → supervisely-6.73.410}/supervisely/io/env.py

@@ -671,3 +671,18 @@ def supervisely_skip_https_user_helper_check() -> bool:
         default=False,
         raise_not_found=False,
     )
+
+
+def configure_minimum_instance_version() -> None:
+    """
+    Configure MINIMUM_INSTANCE_VERSION_FOR_SDK environment variable
+    from the latest entry in versions.json file.
+
+    This function should be called during SDK initialization to automatically
+    set the minimum required instance version based on the versions.json file.
+    """
+    from supervisely._utils import get_latest_instance_version_from_json
+
+    latest_version = get_latest_instance_version_from_json()
+    if latest_version:
+        os.environ["MINIMUM_INSTANCE_VERSION_FOR_SDK"] = latest_version

{supervisely-6.73.408 → supervisely-6.73.410}/supervisely/nn/benchmark/object_detection/vis_metrics/f1_score_at_different_iou.py

@@ -57,6 +57,9 @@ class F1ScoreAtDifferentIOU(DetectionVisMetric):
 
         # add annotations for maximum F1-Score for each IoU threshold
         for i, iou in enumerate(iou_names):
+            # Skip if all F1 scores are NaN for this IoU threshold
+            if np.isnan(f1s[i]).all():
+                continue
             argmax_f1 = np.nanargmax(f1s[i])
             max_f1 = f1s[i][argmax_f1]
             score = self.eval_result.mp.m_full.score_profile["scores"][argmax_f1]

{supervisely-6.73.408 → supervisely-6.73.410}/supervisely/pointcloud_annotation/pointcloud_episode_tag.py

@@ -6,6 +6,7 @@ from typing import Dict, Optional, Tuple, Union
 from supervisely._utils import take_with_default
 from supervisely.annotation.tag_meta import TagMeta
 from supervisely.annotation.tag_meta_collection import TagMetaCollection
+from supervisely.api.module_api import ApiField
 from supervisely.video_annotation.key_id_map import KeyIdMap
 from supervisely.video_annotation.video_tag import VideoTag
 
@@ -30,6 +31,10 @@ class PointcloudEpisodeTag(VideoTag):
     :type updated_at: str, optional
     :param created_at: Date and Time when PointcloudEpisodeTag was created. Date Format is the same as in "updated_at" parameter.
     :type created_at: str, optional
+    :param is_finished: Pointcloud Episode Tag is finished or not (applicable for range tags).
+    :type is_finished: bool, optional
+    :param non_final_value: Pointcloud Episode Tag value is final or not. Can be useful to create tag without value.
+    :type non_final_value: bool, optional
     :Usage example:
 
      .. code-block:: python
@@ -37,7 +42,7 @@ class PointcloudEpisodeTag(VideoTag):
         import supervisely as sly
 
         meta_car = sly.TagMeta('car', sly.TagValueType.NONE)
-        # Now we can create a VideoTag using our TagMeta
+        # Now we can create a PointcloudEpisodeTag using our TagMeta
         tag_car = sly.PointcloudEpisodeTag(meta_car)
         # When you are creating a new Tag
         # Tag.value is automatically cross-checked against your TagMeta value type to make sure the value is valid.
@@ -60,7 +65,7 @@ class PointcloudEpisodeTag(VideoTag):
         # Output: ValueError: Tag car color can not have value yellow
     """
 
-    _SUPPORT_UNFINISHED_TAGS = False
+    _SUPPORT_UNFINISHED_TAGS = True
 
     def __init__(
         self,
@@ -72,6 +77,8 @@ class PointcloudEpisodeTag(VideoTag):
         labeler_login=None,
         updated_at=None,
         created_at=None,
+        is_finished=None,
+        non_final_value=None,
     ):
         super().__init__(
             meta,
@@ -82,6 +89,8 @@ class PointcloudEpisodeTag(VideoTag):
             labeler_login,
             updated_at,
             created_at,
+            is_finished=is_finished,
+            non_final_value=non_final_value,
         )
 
     @classmethod
@@ -121,7 +130,8 @@ class PointcloudEpisodeTag(VideoTag):
 
             tag_car_color = sly.PointcloudEpisodeTag.from_json(tag_car_color_json, meta_car_collection)
         """
-
+        is_finished = data.get(ApiField.IS_FINISHED, True)
+        non_final_value = data.get(ApiField.NON_FINAL_VALUE, False)
         temp = super(PointcloudEpisodeTag, cls).from_json(data, tag_meta_collection, key_id_map)
 
         return cls(
@@ -133,6 +143,8 @@ class PointcloudEpisodeTag(VideoTag):
             labeler_login=temp.labeler_login,
             updated_at=temp.updated_at,
             created_at=temp.created_at,
+            is_finished=is_finished,
+            non_final_value=non_final_value,
         )
 
     def __eq__(self, other: PointcloudEpisodeTag) -> bool:
@@ -148,6 +160,8 @@ class PointcloudEpisodeTag(VideoTag):
         labeler_login: Optional[str] = None,
         updated_at: Optional[str] = None,
         created_at: Optional[str] = None,
+        is_finished: Optional[bool] = None,
+        non_final_value: Optional[bool] = None,
     ) -> PointcloudEpisodeTag:
         """
         Makes a copy of PointcloudEpisodeTag with new fields, if fields are given, otherwise it will use fields of the original PointcloudEpisodeTag.
@@ -168,6 +182,10 @@ class PointcloudEpisodeTag(VideoTag):
         :type updated_at: str, optional
         :param created_at: Date and Time when PointcloudEpisodeTag was created. Date Format is the same as in "updated_at" parameter.
         :type created_at: str, optional
+        :param is_finished: Pointcloud Episode Tag is finished or not (applicable for range tags).
+        :type is_finished: bool, optional
+        :param non_final_value: Pointcloud Episode Tag value is final or not. Can be useful to create tag without value.
+        :type non_final_value: bool, optional
         :Usage example:
 
          .. code-block:: python
@@ -201,4 +219,6 @@ class PointcloudEpisodeTag(VideoTag):
             labeler_login=take_with_default(labeler_login, self.labeler_login),
             updated_at=take_with_default(updated_at, self.updated_at),
             created_at=take_with_default(created_at, self.created_at),
+            is_finished=take_with_default(is_finished, self.is_finished),
+            non_final_value=take_with_default(non_final_value, self.non_final_value),
         )

supervisely-6.73.410/supervisely/versions.json

@@ -0,0 +1,26 @@
+{
+	"6.9.11": "6.72.70",
+	"6.9.13": "6.73.76",
+	"6.9.18": "6.73.81",
+	"6.9.22": "6.73.90",
+	"6.9.31": "6.73.123",
+	"6.10.0": "6.73.126",
+	"6.11.8": "6.73.159",
+	"6.11.10": "6.73.166",
+	"6.11.16": "6.73.184",
+	"6.11.19": "6.73.199",
+	"6.12.2": "6.73.222",
+	"6.12.5": "6.73.226",
+	"6.12.12": "6.73.241",
+	"6.12.17": "6.73.263",
+	"6.12.23": "6.73.281",
+	"6.12.28": "6.73.292",
+	"6.12.30": "6.73.312",
+	"6.12.34": "6.73.324",
+	"6.12.44": "6.73.344",
+	"6.12.46": "6.73.375",
+	"6.13.1": "6.73.379",
+	"6.13.8": "6.73.394",
+	"6.14.0": "6.73.400",
+	"6.14.4": "6.73.410"
+}

{supervisely-6.73.408 → supervisely-6.73.410/supervisely.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: supervisely
-Version: 6.73.408
+Version: 6.73.410
 Summary: Supervisely Python SDK.
 Home-page: https://github.com/supervisely/supervisely
 Author: Supervisely

{supervisely-6.73.408 → supervisely-6.73.410}/supervisely.egg-info/SOURCES.txt

@@ -8,6 +8,7 @@ supervisely/_utils.py
 supervisely/function_wrapper.py
 supervisely/sly_logger.py
 supervisely/tiny_timer.py
+supervisely/versions.json
 supervisely.egg-info/PKG-INFO
 supervisely.egg-info/SOURCES.txt
 supervisely.egg-info/dependency_links.txt

{supervisely-6.73.408 → supervisely-6.73.410}/setup.py

@@ -194,9 +194,9 @@ setup(
             "*.css",
             "*.js",
             "*.md",
-            "versions.json",
         ],
         "supervisely": [
+            "versions.json",
             "video/*.sh",
             "app/development/*.sh",
             "imaging/colors.json.gz",