Release 2.0.0a2

.github/workflows/release_workflow.yml

@@ -1,13 +1,13 @@
 name: Release Alpha and Propose Stable
 
 on:
+  workflow_dispatch:
   pull_request:
     types: [closed]
     branches: [dev]
 
 jobs:
   publish_alpha:
-    if: github.event.pull_request.merged == true
     uses: TigreGotico/gh-automations/.github/workflows/publish-alpha.yml@master
     secrets: inherit
     with:

CHANGELOG.md

@@ -1,12 +1,37 @@
 # Changelog
 
-## [1.0.3a1](https://github.com/OpenVoiceOS/ovos-plugin-manager/tree/1.0.3a1) (2025-06-10)
+## [2.0.0a2](https://github.com/OpenVoiceOS/ovos-plugin-manager/tree/2.0.0a2) (2025-07-22)
 
-[Full Changelog](https://github.com/OpenVoiceOS/ovos-plugin-manager/compare/1.0.2...1.0.3a1)
+[Full Changelog](https://github.com/OpenVoiceOS/ovos-plugin-manager/compare/2.0.0a1...2.0.0a2)
 
 **Merged pull requests:**
 
-- refactor: simplify pipeline factory, missed in previous PR [\#327](https://github.com/OpenVoiceOS/ovos-plugin-manager/pull/327) ([JarbasAl](https://github.com/JarbasAl))
+- Update requests requirement from ~=2.26 to ~=2.32 in /requirements [\#330](https://github.com/OpenVoiceOS/ovos-plugin-manager/pull/330) ([dependabot[bot]](https://github.com/apps/dependabot))
+
+## [2.0.0a1](https://github.com/OpenVoiceOS/ovos-plugin-manager/tree/2.0.0a1) (2025-07-22)
+
+[Full Changelog](https://github.com/OpenVoiceOS/ovos-plugin-manager/compare/1.0.4a2...2.0.0a1)
+
+**Breaking changes:**
+
+- feat!: add collections and batch operations support to embeddings plu… [\#333](https://github.com/OpenVoiceOS/ovos-plugin-manager/pull/333) ([JarbasAl](https://github.com/JarbasAl))
+
+## [1.0.4a2](https://github.com/OpenVoiceOS/ovos-plugin-manager/tree/1.0.4a2) (2025-07-22)
+
+[Full Changelog](https://github.com/OpenVoiceOS/ovos-plugin-manager/compare/1.0.4a3...1.0.4a2)
+
+## [1.0.4a3](https://github.com/OpenVoiceOS/ovos-plugin-manager/tree/1.0.4a3) (2025-07-22)
+
+[Full Changelog](https://github.com/OpenVoiceOS/ovos-plugin-manager/compare/1.0.4a1...1.0.4a3)
+
+**Merged pull requests:**
+
+- Update langcodes requirement from ~=3.3.0 to ~=3.5.0 in /requirements [\#332](https://github.com/OpenVoiceOS/ovos-plugin-manager/pull/332) ([dependabot[bot]](https://github.com/apps/dependabot))
+- Update combo-lock requirement from ~=0.2 to ~=0.3 in /requirements [\#331](https://github.com/OpenVoiceOS/ovos-plugin-manager/pull/331) ([dependabot[bot]](https://github.com/apps/dependabot))
+
+## [1.0.4a1](https://github.com/OpenVoiceOS/ovos-plugin-manager/tree/1.0.4a1) (2025-06-18)
+
+[Full Changelog](https://github.com/OpenVoiceOS/ovos-plugin-manager/compare/1.0.3...1.0.4a1)
 
 
 

ovos_plugin_manager/embeddings.py

@@ -1,78 +1,126 @@
-from ovos_plugin_manager.templates.embeddings import EmbeddingsDB, TextEmbeddingsStore, FaceEmbeddingsStore, VoiceEmbeddingsStore
+from ovos_plugin_manager.templates.embeddings import EmbeddingsDB, ImageEmbedder, TextEmbedder, VoiceEmbedder, FaceEmbedder
 from ovos_plugin_manager.utils import PluginTypes
 
 
-def find_embeddings_plugins() -> dict:
+def find_embeddings_db_plugins() -> dict:
     """
-    Find all installed plugins
-    @return: dict plugin names to entrypoints
+    Discover all installed general embeddings database plugins.
+
+    Returns:
+        dict: A mapping of plugin names to their entrypoints for general embeddings database plugins.
     """
     from ovos_plugin_manager.utils import find_plugins
     return find_plugins(PluginTypes.EMBEDDINGS)
 
 
-def load_embeddings_plugin(module_name: str) -> type(EmbeddingsDB):
+def load_embeddings_db_plugin(module_name: str) -> type(EmbeddingsDB):
     """
-    Get an uninstantiated class for the requested module_name
-    @param module_name: Plugin entrypoint name to load
-    @return: Uninstantiated class
+    Load and return the uninstantiated class of a general embeddings database plugin by its module name.
+
+    Parameters:
+        module_name (str): The entrypoint name of the embeddings database plugin to load.
+
+    Returns:
+        type(EmbeddingsDB): The plugin class corresponding to the specified module name.
     """
     from ovos_plugin_manager.utils import load_plugin
     return load_plugin(module_name, PluginTypes.EMBEDDINGS)
 
 
 def find_voice_embeddings_plugins() -> dict:
     """
-    Find all installed plugins
-    @return: dict plugin names to entrypoints
+    Discover all installed voice embeddings plugins.
+
+    Returns:
+        dict: A mapping of plugin names to their entrypoints for available voice embeddings plugins.
     """
     from ovos_plugin_manager.utils import find_plugins
     return find_plugins(PluginTypes.VOICE_EMBEDDINGS)
 
 
-def load_voice_embeddings_plugin(module_name: str) -> type(VoiceEmbeddingsStore):
+def load_voice_embeddings_plugin(module_name: str) -> type(VoiceEmbedder):
     """
-    Get an uninstantiated class for the requested module_name
-    @param module_name: Plugin entrypoint name to load
-    @return: Uninstantiated class
+    Load and return the uninstantiated class of a voice embeddings plugin by its module name.
+
+    Parameters:
+        module_name (str): The entrypoint name of the voice embeddings plugin to load.
+
+    Returns:
+        type(VoiceEmbedder): The uninstantiated class of the specified voice embeddings plugin.
     """
     from ovos_plugin_manager.utils import load_plugin
     return load_plugin(module_name, PluginTypes.VOICE_EMBEDDINGS)
 
 
+def find_image_embeddings_plugins() -> dict:
+    """
+    Discover all installed image embeddings plugins.
+
+    Returns:
+        dict: A mapping of plugin names to their entrypoints for image embeddings plugins.
+    """
+    from ovos_plugin_manager.utils import find_plugins
+    return find_plugins(PluginTypes.IMAGE_EMBEDDINGS)
+
+
+def load_image_embeddings_plugin(module_name: str) -> type(ImageEmbedder):
+    """
+    Load and return the uninstantiated class of an image embeddings plugin specified by its module name.
+
+    Parameters:
+        module_name (str): The entrypoint name of the image embeddings plugin to load.
+
+    Returns:
+        type(ImageEmbedder): The uninstantiated class of the requested image embeddings plugin.
+    """
+    from ovos_plugin_manager.utils import load_plugin
+    return load_plugin(module_name, PluginTypes.IMAGE_EMBEDDINGS)
+
 def find_face_embeddings_plugins() -> dict:
     """
-    Find all installed plugins
-    @return: dict plugin names to entrypoints
+    Find all installed face embeddings plugins.
+
+    Returns:
+        dict: A mapping of plugin names to their entrypoints for face embeddings plugins.
     """
     from ovos_plugin_manager.utils import find_plugins
     return find_plugins(PluginTypes.FACE_EMBEDDINGS)
 
 
-def load_face_embeddings_plugin(module_name: str) -> type(FaceEmbeddingsStore):
+def load_face_embeddings_plugin(module_name: str) -> type(FaceEmbedder):
     """
-    Get an uninstantiated class for the requested module_name
-    @param module_name: Plugin entrypoint name to load
-    @return: Uninstantiated class
+    Load and return the uninstantiated class of a face embeddings plugin by its module name.
+
+    Parameters:
+        module_name (str): The entrypoint name of the face embeddings plugin to load.
+
+    Returns:
+        type(FaceEmbedder): The uninstantiated class of the specified face embeddings plugin.
     """
     from ovos_plugin_manager.utils import load_plugin
     return load_plugin(module_name, PluginTypes.FACE_EMBEDDINGS)
 
 
 def find_text_embeddings_plugins() -> dict:
     """
-    Find all installed plugins
-    @return: dict plugin names to entrypoints
+    Discover all installed text embeddings plugins.
+
+    Returns:
+        dict: A mapping of plugin names to their entrypoints for text embeddings plugins.
     """
     from ovos_plugin_manager.utils import find_plugins
     return find_plugins(PluginTypes.TEXT_EMBEDDINGS)
 
 
-def load_text_embeddings_plugin(module_name: str) -> type(TextEmbeddingsStore):
+def load_text_embeddings_plugin(module_name: str) -> type(TextEmbedder):
     """
-    Get an uninstantiated class for the requested module_name
-    @param module_name: Plugin entrypoint name to load
-    @return: Uninstantiated class
+    Load and return the uninstantiated class of a text embeddings plugin specified by its module name.
+
+    Parameters:
+        module_name (str): The entrypoint name of the text embeddings plugin to load.
+
+    Returns:
+        type(TextEmbedder): The uninstantiated class of the specified text embeddings plugin.
     """
     from ovos_plugin_manager.utils import load_plugin
     return load_plugin(module_name, PluginTypes.TEXT_EMBEDDINGS)