gllm-inference-binary 0.5.55__cp313-cp313-macosx_13_0_arm64.whl

gllm_inference/catalog/lm_request_processor_catalog.pyi

@@ -0,0 +1,112 @@
+from _typeshed import Incomplete
+from gllm_inference.builder import build_lm_request_processor as build_lm_request_processor
+from gllm_inference.catalog.catalog import BaseCatalog as BaseCatalog
+from gllm_inference.request_processor import LMRequestProcessor as LMRequestProcessor
+
+MODEL_ID_ENV_VAR_REGEX_PATTERN: str
+LM_REQUEST_PROCESSOR_REQUIRED_COLUMNS: Incomplete
+CONFIG_SCHEMA_MAP: Incomplete
+logger: Incomplete
+
+class LMRequestProcessorCatalog(BaseCatalog[LMRequestProcessor]):
+    '''Loads multiple LM request processors from certain sources.
+
+    Attributes:
+        components (dict[str, LMRequestProcessor]): Dictionary of the loaded LM request processors.
+
+    Initialization:
+        # Example 1: Load from Google Sheets using client email and private key
+        ```python
+        catalog = LMRequestProcessorCatalog.from_gsheets(
+            sheet_id="...",
+            worksheet_id="...",
+            client_email="...",
+            private_key="...",
+        )
+
+        lm_request_processor = catalog.name
+        ```
+
+        # Example 2: Load from Google Sheets using credential file
+        ```python
+        catalog = LMRequestProcessorCatalog.from_gsheets(
+            sheet_id="...",
+            worksheet_id="...",
+            credential_file_path="...",
+        )
+
+        lm_request_processor = catalog.name
+        ```
+
+        # Example 3: Load from CSV
+        ```python
+        catalog = LMRequestProcessorCatalog.from_csv(csv_path="...")
+
+        lm_request_processor = catalog.name
+        ```
+
+        # Example 4: Load from record
+        ```python
+        records=[
+            {
+                "name": "answer_question",
+                "system_template": (
+                    "You are helpful assistant.\\n"
+                    "Answer the following question based on the provided context.\\n"
+                    "```{context}```"
+                ),
+                "user_template": "{query}",
+                "key_defaults": \'{"context": "<default context>"}\',
+                "model_id": "openai/gpt-5-nano",
+                "credentials": "OPENAI_API_KEY",
+                "config": "",
+                "output_parser_type": "none",
+            },
+        ]
+        catalog = LMRequestProcessorCatalog.from_records(records=records)
+        lm_request_processor = catalog.answer_question
+        ```
+
+    Template Format Example:
+        # Example 1: Google Sheets
+        For an example of how a Google Sheets file can be formatted to be loaded using LMRequestProcessorCatalog, see:
+        https://docs.google.com/spreadsheets/d/1CX9i45yEinv1UdB3s6uHNMj7mxr2-s1NFHfFDvMsq0E/edit?usp=drive_link
+
+        # Example 2: CSV
+        For an example of how a CSV file can be formatted to be loaded using LMRequestProcessorCatalog, see:
+        https://drive.google.com/file/d/1_2rSoxh3CR2KZxIyUmpowMrt0Lm0YqAb/view?usp=drive_link
+
+    Template Explanation:
+        The required columns are:
+        1. name (str): The name of the LM request processor.
+        2. system_template (str): The system template of the prompt builder.
+        3. user_template (str): The user template of the prompt builder.
+        4. key_defaults (json_str): The default values for the prompt template keys.
+        5. model_id (str): The model ID of the LM invoker.
+        6. credentials (str | json_str): The credentials of the LM invoker.
+        7. config (json_str): The additional configuration of the LM invoker.
+        8. output_parser_type (str): The type of the output parser.
+
+        Important Notes:
+        1. At least one of `system_template` or `user_template` must be filled.
+        2. `key_defaults` is optional. If filled, must be a dictionary containing the default values for the
+            prompt template keys. These default values will be applied when the corresponding keys are not provided
+            in the runtime input. If it is empty, the prompt template keys will not have default values.
+        3. The `model_id`:
+            3.1. Must be filled with the model ID of the LM invoker, e.g. "openai/gpt-5-nano".
+            3.2. Can be partially loaded from the environment variable using the "${ENV_VAR_KEY}" syntax,
+                e.g. "azure-openai/${AZURE_ENDPOINT}/${AZURE_DEPLOYMENT}".
+            3.3. For the available model ID formats, see: https://gdplabs.gitbook.io/sdk/resources/supported-models
+        4. `credentials` is optional. If it is filled, it can either be:
+            4.1. An environment variable name containing the API key (e.g. OPENAI_API_KEY).
+            4.2. An environment variable name containing the path to a credentials JSON file
+                (e.g. GOOGLE_CREDENTIALS_FILE_PATH). Currently only supported for Google Vertex AI.
+            4.3. A dictionary of credentials, with each value being an environment variable name corresponding to the
+                credential (e.g. {"api_key": "OPENAI_API_KEY"}). Currently supported for Bedrock and LangChain.
+            If it is empty, the LM invoker will use the default credentials loaded from the environment variables.
+        5. `config` is optional. If filled, must be a dictionary containing the configuration for the LM invoker.
+            If it is empty, the LM invoker will use the default configuration.
+        6. `output_parser_type` can either be:
+            6.1. none: No output parser will be used.
+            6.2. json: The JSONOutputParser will be used.
+    '''

gllm_inference/catalog/prompt_builder_catalog.pyi

@@ -0,0 +1,82 @@
+from _typeshed import Incomplete
+from gllm_inference.catalog.catalog import BaseCatalog as BaseCatalog
+from gllm_inference.prompt_builder.prompt_builder import PromptBuilder as PromptBuilder
+
+PROMPT_BUILDER_REQUIRED_COLUMNS: Incomplete
+logger: Incomplete
+
+class PromptBuilderCatalog(BaseCatalog[PromptBuilder]):
+    '''Loads multiple prompt builders from certain sources.
+
+    Attributes:
+        components (dict[str, PromptBuilder]): Dictionary of the loaded prompt builders.
+
+    Initialization:
+        # Example 1: Load from Google Sheets using client email and private key
+        ```python
+        catalog = PromptBuilderCatalog.from_gsheets(
+            sheet_id="...",
+            worksheet_id="...",
+            client_email="...",
+            private_key="...",
+        )
+        prompt_builder = catalog.name
+        ```
+
+        # Example 2: Load from Google Sheets using credential file
+        ```python
+        catalog = PromptBuilderCatalog.from_gsheets(
+            sheet_id="...",
+            worksheet_id="...",
+            credential_file_path="...",
+        )
+        prompt_builder = catalog.name
+        ```
+
+        # Example 3: Load from CSV
+        ```python
+        catalog = PromptBuilderCatalog.from_csv(csv_path="...")
+        prompt_builder = catalog.name
+        ```
+
+        # Example 4: Load from records
+        ```python
+        records=[
+            {
+                "name": "answer_question",
+                "system": (
+                    "You are helpful assistant.\\n"
+                    "Answer the following question based on the provided context.\\n"
+                    "```{context}```"
+                ),
+                "user": "{query}",
+                "key_defaults": \'{"context": "<default context>"}\',
+            },
+        ]
+        catalog = PromptBuilderCatalog.from_records(records=records)
+        prompt_builder = catalog.answer_question
+        ```
+
+    Template Example:
+        # Example 1: Google Sheets
+        For an example of how a Google Sheets file can be formatted to be loaded using PromptBuilderCatalog, see:
+        https://docs.google.com/spreadsheets/d/12IwSKv8hMhyWXSQnLx9LgCj0cxaR1f9gOmbEDGleurE/edit?usp=drive_link
+
+        # Example 2: CSV
+        For an example of how a CSV file can be formatted to be loaded using PromptBuilderCatalog, see:
+        https://drive.google.com/file/d/1KQgddMdbcZBZmroQFtjSl-TKLohq84Fz/view?usp=drive_link
+
+
+    Template explanation:
+        The required columns are:
+        1. name (str): The name of the prompt builder.
+        2. system (str): The system template of the prompt builder.
+        3. user (str): The user template of the prompt builder.
+        4. key_defaults (json_str): The default values for the prompt template keys.
+
+        Important Notes:
+        1. At least one of the `system` and `user` columns must be filled.
+        2. `key_defaults` is optional. If filled, must be a dictionary containing the default values for the
+            prompt template keys. These default values will be applied when the corresponding keys are not provided
+            in the runtime input. If it is empty, the prompt template keys will not have default values.
+    '''

gllm_inference/constants.pyi

@@ -0,0 +1,12 @@
+from _typeshed import Incomplete
+
+AZURE_OPENAI_URL_SUFFIX: str
+DOCUMENT_MIME_TYPES: Incomplete
+EMBEDDING_ENDPOINT: str
+GOOGLE_SCOPES: Incomplete
+GRPC_ENABLE_RETRIES_KEY: str
+INVOKER_DEFAULT_TIMEOUT: float
+INVOKER_PROPAGATED_MAX_RETRIES: int
+JINA_DEFAULT_URL: str
+OPENAI_DEFAULT_URL: str
+SECONDS_TO_MILLISECONDS: int

gllm_inference/em_invoker/__init__.pyi

@@ -0,0 +1,12 @@
+from gllm_inference.em_invoker.azure_openai_em_invoker import AzureOpenAIEMInvoker as AzureOpenAIEMInvoker
+from gllm_inference.em_invoker.bedrock_em_invoker import BedrockEMInvoker as BedrockEMInvoker
+from gllm_inference.em_invoker.cohere_em_invoker import CohereEMInvoker as CohereEMInvoker
+from gllm_inference.em_invoker.google_em_invoker import GoogleEMInvoker as GoogleEMInvoker
+from gllm_inference.em_invoker.jina_em_invoker import JinaEMInvoker as JinaEMInvoker
+from gllm_inference.em_invoker.langchain_em_invoker import LangChainEMInvoker as LangChainEMInvoker
+from gllm_inference.em_invoker.openai_compatible_em_invoker import OpenAICompatibleEMInvoker as OpenAICompatibleEMInvoker
+from gllm_inference.em_invoker.openai_em_invoker import OpenAIEMInvoker as OpenAIEMInvoker
+from gllm_inference.em_invoker.twelevelabs_em_invoker import TwelveLabsEMInvoker as TwelveLabsEMInvoker
+from gllm_inference.em_invoker.voyage_em_invoker import VoyageEMInvoker as VoyageEMInvoker
+
+__all__ = ['AzureOpenAIEMInvoker', 'BedrockEMInvoker', 'CohereEMInvoker', 'GoogleEMInvoker', 'JinaEMInvoker', 'LangChainEMInvoker', 'OpenAIEMInvoker', 'OpenAICompatibleEMInvoker', 'TwelveLabsEMInvoker', 'VoyageEMInvoker']

gllm_inference/em_invoker/azure_openai_em_invoker.pyi

@@ -0,0 +1,88 @@
+from _typeshed import Incomplete
+from gllm_core.utils.retry import RetryConfig as RetryConfig
+from gllm_inference.constants import AZURE_OPENAI_URL_SUFFIX as AZURE_OPENAI_URL_SUFFIX, INVOKER_PROPAGATED_MAX_RETRIES as INVOKER_PROPAGATED_MAX_RETRIES
+from gllm_inference.em_invoker.openai_em_invoker import OpenAIEMInvoker as OpenAIEMInvoker
+from gllm_inference.em_invoker.schema.openai import Key as Key
+from gllm_inference.schema import ModelId as ModelId, ModelProvider as ModelProvider, TruncationConfig as TruncationConfig
+from typing import Any
+
+class AzureOpenAIEMInvoker(OpenAIEMInvoker):
+    '''An embedding model invoker to interact with Azure OpenAI embedding models.
+
+    Attributes:
+        model_id (str): The model ID of the embedding model.
+        model_provider (str): The provider of the embedding model.
+        model_name (str): The name of the Azure OpenAI embedding model deployment.
+        client_kwargs (dict[str, Any]): The keyword arguments for the Azure OpenAI client.
+        default_hyperparameters (dict[str, Any]): Default hyperparameters for invoking the embedding model.
+        retry_config (RetryConfig): The retry configuration for the embedding model.
+        truncation_config (TruncationConfig | None): The truncation configuration for the embedding model.
+
+    Input types:
+        The `AzureOpenAIEMInvoker` only supports text inputs.
+
+    Output format:
+        The `AzureOpenAIEMInvoker` can embed either:
+        1. A single content.
+           1. A single content is a single text.
+           2. The output will be a `Vector`, representing the embedding of the content.
+
+           # Example 1: Embedding a text content.
+           ```python
+           text = "This is a text"
+           result = await em_invoker.invoke(text)
+           ```
+
+           The above examples will return a `Vector` with a size of (embedding_size,).
+
+        2. A list of contents.
+           1. A list of contents is a list of texts.
+           2. The output will be a `list[Vector]`, where each element is a `Vector` representing the
+              embedding of each single content.
+
+           # Example: Embedding a list of contents.
+           ```python
+           text1 = "This is a text"
+           text2 = "This is another text"
+           text3 = "This is yet another text"
+           result = await em_invoker.invoke([text1, text2, text3])
+           ```
+
+           The above examples will return a `list[Vector]` with a size of (3, embedding_size).
+
+    Retry and timeout:
+        The `AzureOpenAIEMInvoker` supports retry and timeout configuration.
+        By default, the max retries is set to 0 and the timeout is set to 30.0 seconds.
+        They can be customized by providing a custom `RetryConfig` object to the `retry_config` parameter.
+
+        Retry config examples:
+        ```python
+        retry_config = RetryConfig(max_retries=0, timeout=None)  # No retry, no timeout
+        retry_config = RetryConfig(max_retries=0, timeout=10.0)  # No retry, 10.0 seconds timeout
+        retry_config = RetryConfig(max_retries=5, timeout=None)  # 5 max retries, no timeout
+        retry_config = RetryConfig(max_retries=5, timeout=10.0)  # 5 max retries, 10.0 seconds timeout
+        ```
+
+        Usage example:
+        ```python
+        em_invoker = AzureOpenAIEMInvoker(..., retry_config=retry_config)
+        ```
+    '''
+    client_kwargs: Incomplete
+    def __init__(self, azure_endpoint: str, azure_deployment: str, api_key: str | None = None, api_version: str | None = None, model_kwargs: dict[str, Any] | None = None, default_hyperparameters: dict[str, Any] | None = None, retry_config: RetryConfig | None = None, truncation_config: TruncationConfig | None = None) -> None:
+        """Initializes a new instance of the AzureOpenAIEMInvoker class.
+
+        Args:
+            azure_endpoint (str): The endpoint of the Azure OpenAI service.
+            azure_deployment (str): The deployment name of the Azure OpenAI service.
+            api_key (str | None, optional): The API key for authenticating with Azure OpenAI. Defaults to None, in
+                which case the `AZURE_OPENAI_API_KEY` environment variable will be used.
+            api_version (str | None, optional): Deprecated parameter to be removed in v0.6. Defaults to None.
+            model_kwargs (dict[str, Any] | None, optional): Additional model parameters. Defaults to None.
+            default_hyperparameters (dict[str, Any] | None, optional): Default hyperparameters for invoking the model.
+                Defaults to None.
+            retry_config (RetryConfig | None, optional): The retry configuration for the embedding model.
+                Defaults to None, in which case a default config with no retry and 30.0 seconds timeout will be used.
+            truncation_config (TruncationConfig | None, optional): Configuration for text truncation behavior.
+                Defaults to None, in which case no truncation is applied.
+        """

gllm_inference/em_invoker/bedrock_em_invoker.pyi

@@ -0,0 +1,118 @@
+from _typeshed import Incomplete
+from enum import StrEnum
+from gllm_core.utils.retry import RetryConfig as RetryConfig
+from gllm_inference.em_invoker.em_invoker import BaseEMInvoker as BaseEMInvoker
+from gllm_inference.em_invoker.schema.bedrock import InputType as InputType, Key as Key, OutputType as OutputType
+from gllm_inference.exceptions import BaseInvokerError as BaseInvokerError, convert_http_status_to_base_invoker_error as convert_http_status_to_base_invoker_error
+from gllm_inference.exceptions.provider_error_map import BEDROCK_ERROR_MAPPING as BEDROCK_ERROR_MAPPING
+from gllm_inference.schema import Attachment as Attachment, AttachmentType as AttachmentType, EMContent as EMContent, ModelId as ModelId, ModelProvider as ModelProvider, TruncationConfig as TruncationConfig, Vector as Vector
+from typing import Any
+
+class ModelType(StrEnum):
+    """Defines the type of the Bedrock embedding model."""
+    COHERE = 'cohere'
+    MARENGO = 'marengo'
+    TITAN = 'titan'
+
+SUPPORTED_ATTACHMENTS: Incomplete
+
+class BedrockEMInvoker(BaseEMInvoker):
+    '''An embedding model invoker to interact with AWS Bedrock embedding models.
+
+    Attributes:
+        model_id (str): The model ID of the embedding model.
+        model_provider (str): The provider of the embedding model.
+        model_name (str): The name of the embedding model.
+        session (Session): The Bedrock client session.
+        client_kwargs (dict[str, Any]): The Bedrock client kwargs.
+        default_hyperparameters (dict[str, Any]): Default hyperparameters for invoking the embedding model.
+        retry_config (RetryConfig): The retry configuration for the embedding model.
+        truncation_config (TruncationConfig | None): The truncation configuration for the embedding model.
+
+    Input types:
+        The `BedrockEMInvoker` supports:
+        1. Text inputs for Cohere, Titan, and Marengo models
+        2. Image inputs for Marengo models through Attachment objects
+
+    Output format:
+        The `BedrockEMInvoker` can embed either:
+        1. A single content.
+           1. A single content is a single text or single image (image only supported for Marengo).
+           2. The output will be a `Vector`, representing the embedding of the content.
+
+           # Example 1: Embedding a text content.
+           ```python
+           text = "This is a text"
+           result = await em_invoker.invoke(text)
+           ```
+
+           # Example 2: Embedding an image with Marengo.
+           ```python
+           em_invoker = BedrockEMInvoker(
+               model_name="us.twelvelabs.marengo-2.7"
+           )
+           image = Attachment.from_path("path/to/local/image.png")
+           result = await em_invoker.invoke(image)
+           ```
+
+           The above examples will return a `Vector` with a size of (embedding_size,).
+
+        2. A list of contents.
+           1. A list of contents is a list of texts or images (images only supported for Marengo).
+           2. The output will be a `list[Vector]`, where each element is a `Vector` representing the
+              embedding of each single content.
+
+           # Example: Embedding a list of contents.
+           ```python
+           text1 = "This is a text"
+           text2 = "This is another text"
+           text3 = "This is yet another text"
+           result = await em_invoker.invoke([text1, text2, text3])
+           ```
+
+           The above examples will return a `list[Vector]` with a size of (3, embedding_size).
+
+    Retry and timeout:
+        The `BedrockEMInvoker` supports retry and timeout configuration.
+        By default, the max retries is set to 0 and the timeout is set to 30.0 seconds.
+        They can be customized by providing a custom `RetryConfig` object to the `retry_config` parameter.
+
+        Retry config examples:
+        ```python
+        retry_config = RetryConfig(max_retries=0, timeout=None)  # No retry, no timeout
+        retry_config = RetryConfig(max_retries=0, timeout=10.0)  # No retry, 10.0 seconds timeout
+        retry_config = RetryConfig(max_retries=5, timeout=None)  # 5 max retries, no timeout
+        retry_config = RetryConfig(max_retries=5, timeout=10.0)  # 5 max retries, 10.0 seconds timeout
+        ```
+
+        Usage example:
+        ```python
+        em_invoker = BedrockEMInvoker(..., retry_config=retry_config)
+        ```
+    '''
+    session: Incomplete
+    client_kwargs: Incomplete
+    def __init__(self, model_name: str, access_key_id: str | None = None, secret_access_key: str | None = None, region_name: str = 'us-east-1', model_kwargs: dict[str, Any] | None = None, default_hyperparameters: dict[str, Any] | None = None, retry_config: RetryConfig | None = None, truncation_config: TruncationConfig | None = None) -> None:
+        '''Initializes a new instance of the BedrockEMInvoker class.
+
+        Args:
+            model_name (str): The name of the Bedrock embedding model to be used.
+            access_key_id (str | None, optional): The AWS access key ID. Defaults to None, in which case
+                the `AWS_ACCESS_KEY_ID` environment variable will be used.
+            secret_access_key (str | None, optional): The AWS secret access key. Defaults to None, in which case
+                the `AWS_SECRET_ACCESS_KEY` environment variable will be used.
+            region_name (str, optional): The AWS region name. Defaults to "us-east-1".
+            model_kwargs (dict[str, Any] | None, optional): Additional keyword arguments for the Bedrock client.
+                Defaults to None.
+            default_hyperparameters (dict[str, Any] | None, optional): Default hyperparameters for invoking the model.
+                Defaults to None.
+            retry_config (RetryConfig | None, optional): The retry configuration for the embedding model.
+                Defaults to None, in which case a default config with no retry and 30.0 seconds timeout will be used.
+            truncation_config (TruncationConfig | None, optional): Configuration for text truncation behavior.
+                Defaults to None, in which case no truncation is applied.
+
+        Raises:
+            ValueError: If the model name is not supported.
+            ValueError: If `access_key_id` or `secret_access_key` is neither provided nor set in the
+                `AWS_ACCESS_KEY_ID` or `AWS_SECRET_ACCESS_KEY` environment variables, respectively.
+        '''

gllm_inference/em_invoker/cohere_em_invoker.pyi

@@ -0,0 +1,128 @@
+from _typeshed import Incomplete
+from gllm_core.utils.retry import RetryConfig as RetryConfig
+from gllm_inference.em_invoker.em_invoker import BaseEMInvoker as BaseEMInvoker
+from gllm_inference.em_invoker.schema.cohere import CohereInputType as CohereInputType, Key as Key
+from gllm_inference.schema import Attachment as Attachment, AttachmentType as AttachmentType, EMContent as EMContent, ModelId as ModelId, ModelProvider as ModelProvider, TruncationConfig as TruncationConfig, Vector as Vector
+from gllm_inference.utils import validate_string_enum as validate_string_enum
+from typing import Any
+
+SUPPORTED_ATTACHMENTS: Incomplete
+MULTIMODAL_MODEL_VERSION: Incomplete
+
+class CohereEMInvoker(BaseEMInvoker):
+    '''An embedding model invoker to interact with Cohere embedding models.
+
+    Attributes:
+        model_id (str): The model ID of the embedding model.
+        model_provider (str): The provider of the embedding model (Cohere).
+        model_name (str): The name of the Cohere embedding model.
+        client (AsyncClient): The asynchronous client for the Cohere API.
+        default_hyperparameters (dict[str, Any]): Default hyperparameters for invoking the embedding model.
+        retry_config (RetryConfig): The retry configuration for the embedding model.
+        truncation_config (TruncationConfig | None): The truncation configuration for the embedding model.
+        input_type (CohereInputType): The input type for the embedding model. Supported values include:
+            1. `CohereInputType.SEARCH_DOCUMENT`,
+            2. `CohereInputType.SEARCH_QUERY`,
+            3. `CohereInputType.CLASSIFICATION`,
+            4. `CohereInputType.CLUSTERING`,
+            5. `CohereInputType.IMAGE`.
+
+    Initialization:
+        You can initialize the `CohereEMInvoker` as follows:
+        ```python
+        em_invoker = CohereEMInvoker(
+            model_name="embed-english-v4.0",
+            input_type="search_document"
+        )
+        ```
+
+        Note: The `input_type` parameter can be one of the following:
+        1. "search_document"
+        2. "search_query"
+        3. "classification"
+        4. "clustering"
+        5. "image"
+
+        This parameter is optional and defaults to "search_document". For more information about
+        input_type, please refer to https://docs.cohere.com/docs/embeddings#the-input_type-parameter.
+
+    Input types:
+        The `CohereEMInvoker` supports the following input types: text and image.
+        Non-text inputs must be passed as an `Attachment` object.
+
+    Output format:
+        The `CohereEMInvoker` can embed either:
+        1. A single content.
+           1. A single content is either a text or an image.
+           2. The output will be a `Vector`, representing the embedding of the content.
+
+           # Example 1: Embedding a text content.
+           ```python
+           text = "What animal is in this image?"
+           result = await em_invoker.invoke(text)
+           ```
+
+           # Example 2: Embedding an image content.
+           ```python
+           image = Attachment.from_path("path/to/local/image.png")
+           result = await em_invoker.invoke(image)
+           ```
+
+           The above examples will return a `Vector` with a size of (embedding_size,).
+
+        2. A list of contents.
+           1. A list of contents is a list that consists of any of the above single contents.
+           2. The output will be a `list[Vector]`, where each element is a `Vector` representing the
+              embedding of each single content.
+
+           # Example: Embedding a list of contents.
+           ```python
+           text = "What animal is in this image?"
+           image = Attachment.from_path("path/to/local/image.png")
+           result = await em_invoker.invoke([text, image])
+           ```
+
+           The above examples will return a `list[Vector]` with a size of (2, embedding_size).
+
+    Retry and timeout:
+        The `CohereEMInvoker` supports retry and timeout configuration.
+        By default, the max retries is set to 0 and the timeout is set to 30.0 seconds.
+        They can be customized by providing a custom `RetryConfig` object to the `retry_config` parameter.
+
+        Retry config examples:
+        ```python
+        retry_config = RetryConfig(max_retries=0, timeout=None)  # No retry, no timeout
+        retry_config = RetryConfig(max_retries=0, timeout=10.0)  # No retry, 10.0 seconds timeout
+        retry_config = RetryConfig(max_retries=5, timeout=None)  # 5 max retries, no timeout
+        retry_config = RetryConfig(max_retries=5, timeout=10.0)  # 5 max retries, 10.0 seconds timeout
+        ```
+
+        Usage example:
+        ```python
+        em_invoker = CohereEMInvoker(..., retry_config=retry_config)
+        ```
+
+    '''
+    input_type: Incomplete
+    client: Incomplete
+    def __init__(self, model_name: str, api_key: str | None = None, base_url: str | None = None, model_kwargs: dict[str, Any] | None = None, default_hyperparameters: dict[str, Any] | None = None, retry_config: RetryConfig | None = None, truncation_config: TruncationConfig | None = None, input_type: CohereInputType = ...) -> None:
+        '''Initializes a new instance of the CohereEMInvoker class.
+
+        Args:
+            model_name (str): The name of the Cohere embedding model to be used.
+            api_key (str | None, optional): The API key for authenticating with Cohere. Defaults to None, in which
+                case the `COHERE_API_KEY` environment variable will be used.
+            base_url (str | None, optional): The base URL for a custom Cohere-compatible endpoint.
+                Defaults to None, in which case Cohere\'s default URL will be used.
+            model_kwargs (dict[str, Any] | None, optional): Additional keyword arguments for the Cohere client.
+                Defaults to None.
+            default_hyperparameters (dict[str, Any] | None, optional): Default hyperparameters for invoking the model.
+                Defaults to None.
+            retry_config (RetryConfig | None, optional): The retry configuration for the embedding model.
+                Defaults to None, in which case a default config with no retry and 30.0 seconds timeout will be used.
+            truncation_config (TruncationConfig | None, optional): Configuration for text truncation behavior.
+                Defaults to None, in which case no truncation is applied.
+            input_type (CohereInputType, optional): The input type for the embedding model.
+                Defaults to `CohereInputType.SEARCH_DOCUMENT`. Valid values are: "search_document", "search_query",
+                "classification", "clustering", and "image".
+        '''

gllm_inference/em_invoker/em_invoker.pyi

@@ -0,0 +1,90 @@
+import abc
+from _typeshed import Incomplete
+from abc import ABC
+from gllm_core.utils.retry import RetryConfig
+from gllm_inference.constants import DOCUMENT_MIME_TYPES as DOCUMENT_MIME_TYPES, INVOKER_DEFAULT_TIMEOUT as INVOKER_DEFAULT_TIMEOUT
+from gllm_inference.exceptions import BaseInvokerError as BaseInvokerError, convert_to_base_invoker_error as convert_to_base_invoker_error
+from gllm_inference.schema import Attachment as Attachment, AttachmentType as AttachmentType, EMContent as EMContent, ModelId as ModelId, TruncateSide as TruncateSide, TruncationConfig as TruncationConfig, Vector as Vector
+from typing import Any
+
+class BaseEMInvoker(ABC, metaclass=abc.ABCMeta):
+    """A base class for embedding model invokers used in Gen AI applications.
+
+    The `BaseEMInvoker` class provides a framework for invoking embedding models.
+
+    Attributes:
+        model_id (str): The model ID of the embedding model.
+        model_provider (str): The provider of the embedding model.
+        model_name (str): The name of the embedding model.
+        default_hyperparameters (dict[str, Any]): Default hyperparameters for invoking the
+            embedding model. Defaults to None, in which case an empty dictionary is used.
+        retry_config (RetryConfig): The retry configuration for the embedding model.
+            Defaults to None, in which case a default config with no retry and 30.0 seconds timeout will be used.
+        truncation_config (TruncationConfig | None): The truncation configuration for the embedding model.
+            Defaults to None, in which case no truncation is applied.
+    """
+    default_hyperparameters: Incomplete
+    retry_config: Incomplete
+    truncation_config: Incomplete
+    def __init__(self, model_id: ModelId, default_hyperparameters: dict[str, Any] | None = None, supported_attachments: set[str] | None = None, retry_config: RetryConfig | None = None, truncation_config: TruncationConfig | None = None) -> None:
+        """Initializes a new instance of the BaseEMInvoker class.
+
+        Args:
+            model_id (ModelId): The model ID of the embedding model.
+            default_hyperparameters (dict[str, Any] | None, optional): Default hyperparameters for invoking the
+                embedding model. Defaults to None, in which case an empty dictionary is used.
+            supported_attachments (set[str] | None, optional): A set of supported attachment types. Defaults to None,
+                in which case an empty set is used (indicating that no attachments are supported).
+            retry_config (RetryConfig | None, optional): The retry configuration for the embedding model.
+                Defaults to None, in which case a default config with no retry and 30.0 seconds timeout will be used.
+            truncation_config (TruncationConfig | None, optional): Configuration for text truncation behavior.
+                Defaults to None, in which case no truncation is applied.
+        """
+    @property
+    def model_id(self) -> str:
+        """The model ID of the embedding model.
+
+        Returns:
+            str: The model ID of the embedding model.
+        """
+    @property
+    def model_provider(self) -> str:
+        """The provider of the embedding model.
+
+        Returns:
+            str: The provider of the embedding model.
+        """
+    @property
+    def model_name(self) -> str:
+        """The name of the embedding model.
+
+        Returns:
+            str: The name of the embedding model.
+        """
+    async def invoke(self, content: EMContent | list[EMContent], hyperparameters: dict[str, Any] | None = None) -> Vector | list[Vector]:
+        """Invokes the embedding model with the provided content or list of contents.
+
+        This method invokes the embedding model with the provided content or list of contents.
+        It includes retry logic with exponential backoff for transient failures.
+
+        Args:
+            content (EMContent | list[EMContent]): The input or list of inputs to be embedded using the embedding model.
+            hyperparameters (dict[str, Any] | None, optional): A dictionary of hyperparameters for the embedding model.
+                Defaults to None, in which case the default hyperparameters are used.
+
+        Returns:
+            Vector | list[Vector]: The vector representations of the input contents:
+                1. If the input is an `EMContent`, the output is a `Vector`.
+                2. If the input is a `list[EMContent]`, the output is a `list[Vector]`.
+
+        Raises:
+            CancelledError: If the invocation is cancelled.
+            ModelNotFoundError: If the model is not found.
+            ProviderAuthError: If the model authentication fails.
+            ProviderInternalError: If the model internal error occurs.
+            ProviderInvalidArgsError: If the model parameters are invalid.
+            ProviderOverloadedError: If the model is overloaded.
+            ProviderRateLimitError: If the model rate limit is exceeded.
+            TimeoutError: If the invocation times out.
+            ValueError: If the input content is invalid.
+        """