SimplerLLM 0.3.2.1__tar.gz → 0.3.2.2__tar.gz

{simplerllm-0.3.2.1 → simplerllm-0.3.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: SimplerLLM
-Version: 0.3.2.1
+Version: 0.3.2.2
 Summary: An easy-to-use Library for interacting with language models.
 Home-page: https://github.com/hassancs91/SimplerLLM
 Author: Hasan Aboul Hasan

{simplerllm-0.3.2.1 → simplerllm-0.3.2.2}/SimplerLLM/language/llm/reliable.py

@@ -91,10 +91,12 @@ class ReliableLLM:
         full_response: bool = False,
         return_provider: bool = False,
         json_mode=False,
+        images: list = None,
+        detail: str = "auto",
     ) -> Union[str, LLMFullResponse, Tuple[Union[str, LLMFullResponse], LLMProvider, str]]:
         """
         Generate a response using the primary LLM, falling back to secondary if primary fails.
-        
+
         Args:
             model_name (str, optional): The name of the model to use.
             prompt (str, optional): A single prompt string to generate a response for.
@@ -105,12 +107,15 @@ class ReliableLLM:
             top_p (float, optional): Controls diversity of output.
             full_response (bool, optional): If True, returns the full API response.
             return_provider (bool, optional): If True, returns a tuple of (response, provider) where provider is the LLMProvider that generated the response.
-            
+            json_mode (bool, optional): If True, enables JSON mode for structured output.
+            images (list, optional): A list of image URLs or file paths for vision tasks.
+            detail (str, optional): Level of detail for image analysis ("low", "high", "auto"). OpenAI-specific parameter. Defaults to "auto".
+
         Returns:
-            Union[str, dict, Tuple[Union[str, dict], LLMProvider, str]]: 
+            Union[str, dict, Tuple[Union[str, dict], LLMProvider, str]]:
                 - If return_provider is False: The generated response from either primary or secondary LLM
                 - If return_provider is True: A tuple of (response, provider, model_name) where provider is the LLMProvider that was used and model_name is the name of the model
-            
+
         Raises:
             Exception: If both primary and secondary LLMs fail
         """
@@ -128,6 +133,8 @@ class ReliableLLM:
                     top_p=top_p,
                     full_response=full_response,
                     json_mode=json_mode,
+                    images=images,
+                    detail=detail,
                 )
                 if self.verbose:
                     verbose_print("Primary provider generated response successfully", "info")
@@ -147,6 +154,8 @@ class ReliableLLM:
                         top_p=top_p,
                         full_response=full_response,
                         json_mode=json_mode,
+                        images=images,
+                        detail=detail,
                     )
                     if self.verbose:
                         verbose_print("Secondary provider generated response successfully", "info")
@@ -167,6 +176,8 @@ class ReliableLLM:
                 top_p=top_p,
                 full_response=full_response,
                 json_mode=json_mode,
+                images=images,
+                detail=detail,
             )
             if self.verbose:
                 verbose_print("Secondary provider generated response successfully", "info")
@@ -187,10 +198,12 @@ class ReliableLLM:
         full_response: bool = False,
         return_provider: bool = False,
         json_mode: bool = False,
+        images: list = None,
+        detail: str = "auto",
     ) -> Union[str, LLMFullResponse, Tuple[Union[str, LLMFullResponse], LLMProvider, str]]:
         """
         Asynchronously generate a response using the primary LLM, falling back to secondary if primary fails.
-        
+
         Args:
             model_name (str, optional): The name of the model to use.
             prompt (str, optional): A single prompt string to generate a response for.
@@ -201,12 +214,15 @@ class ReliableLLM:
             top_p (float, optional): Controls diversity of output.
             full_response (bool, optional): If True, returns the full API response.
             return_provider (bool, optional): If True, returns a tuple of (response, provider) where provider is the LLMProvider that generated the response.
-            
+            json_mode (bool, optional): If True, enables JSON mode for structured output.
+            images (list, optional): A list of image URLs or file paths for vision tasks.
+            detail (str, optional): Level of detail for image analysis ("low", "high", "auto"). OpenAI-specific parameter. Defaults to "auto".
+
         Returns:
-            Union[str, dict, Tuple[Union[str, dict], LLMProvider, str]]: 
+            Union[str, dict, Tuple[Union[str, dict], LLMProvider, str]]:
                 - If return_provider is False: The generated response from either primary or secondary LLM
                 - If return_provider is True: A tuple of (response, provider, model_name) where provider is the LLMProvider that was used and model_name is the name of the model
-            
+
         Raises:
             Exception: If both primary and secondary LLMs fail
         """
@@ -224,6 +240,8 @@ class ReliableLLM:
                     top_p=top_p,
                     full_response=full_response,
                     json_mode=json_mode,
+                    images=images,
+                    detail=detail,
                 )
                 if self.verbose:
                     verbose_print("Primary provider generated response successfully", "info")
@@ -243,6 +261,8 @@ class ReliableLLM:
                         top_p=top_p,
                         full_response=full_response,
                         json_mode=json_mode,
+                        images=images,
+                        detail=detail,
                     )
                     if self.verbose:
                         verbose_print("Secondary provider generated response successfully", "info")
@@ -263,6 +283,8 @@ class ReliableLLM:
                 top_p=top_p,
                 full_response=full_response,
                 json_mode=json_mode,
+                images=images,
+                detail=detail,
             )
             if self.verbose:
                 verbose_print("Secondary provider generated response successfully", "info")

{simplerllm-0.3.2.1 → simplerllm-0.3.2.2}/SimplerLLM/language/llm_addons.py

@@ -76,6 +76,8 @@ def generate_pydantic_json_model(
     custom_prompt_suffix: str = None,
     system_prompt: str = "The Output is a VALID Structured JSON",
     full_response: bool = False,
+    images: list = None,
+    detail: str = "auto",
 ) -> Union[BaseModel, LLMFullResponse, str]:
     """
     Generates a model instance based on a given prompt, retrying on validation errors.
@@ -91,8 +93,10 @@ def generate_pydantic_json_model(
     :param custom_prompt_suffix: Optional string to customize or override the generated prompt extension.
     :param system_prompt: System prompt to set the context for the LLM.
     :param full_response: If True, returns the full API response including token counts.
+    :param images: A list of image URLs or file paths for vision tasks.
+    :param detail: Level of detail for image analysis ("low", "high", "auto"). OpenAI-specific parameter. Defaults to "auto".
 
-    :return: 
+    :return:
         - If full_response=False: BaseModel object
         - If full_response=True: LLMFullResponse object with model_object attribute and input_token_count and output_token_count
         - Error message string if unsuccessful
@@ -110,7 +114,9 @@ def generate_pydantic_json_model(
                 temperature=temperature,
                 top_p=top_p,
                 json_mode=True,
-                full_response=full_response
+                full_response=full_response,
+                images=images,
+                detail=detail,
             )
 
             response_text = ai_response.generated_text if full_response else ai_response
@@ -162,6 +168,8 @@ def generate_pydantic_json_model_reliable(
     custom_prompt_suffix: str = None,
     system_prompt: str = "The Output is a VALID Structured JSON",
     full_response: bool = False,
+    images: list = None,
+    detail: str = "auto",
 ) -> Union[Tuple[BaseModel, LLMProvider, str], LLMFullResponse, str]:
     """
     Generates a model instance using ReliableLLM with fallback capability.
@@ -177,8 +185,10 @@ def generate_pydantic_json_model_reliable(
     :param custom_prompt_suffix: Optional string to customize or override the generated prompt extension.
     :param system_prompt: System prompt to set the context for the LLM.
     :param full_response: If True, returns the full API response including token counts.
+    :param images: A list of image URLs or file paths for vision tasks.
+    :param detail: Level of detail for image analysis ("low", "high", "auto"). OpenAI-specific parameter. Defaults to "auto".
 
-    :return: 
+    :return:
         - If full_response=False: Tuple of (model_object, provider, model_name)
         - If full_response=True: LLMFullResponse object with model_object, provider, and model_name attributes, and input_token_count and output_token_count
         - Error message string if unsuccessful
@@ -196,7 +206,9 @@ def generate_pydantic_json_model_reliable(
                 temperature=temperature,
                 top_p=top_p,
                 json_mode=True,
-                full_response=full_response
+                full_response=full_response,
+                images=images,
+                detail=detail,
             )
             
             if full_response:
@@ -253,6 +265,8 @@ async def generate_pydantic_json_model_reliable_async(
     custom_prompt_suffix: str = None,
     system_prompt: str = "The Output is a VALID Structured JSON",
     full_response: bool = False,
+    images: list = None,
+    detail: str = "auto",
 ) -> Union[Tuple[BaseModel, LLMProvider, str], LLMFullResponse, str]:
     """
     Asynchronously generates a model instance using ReliableLLM with fallback capability.
@@ -268,8 +282,10 @@ async def generate_pydantic_json_model_reliable_async(
     :param custom_prompt_suffix: Optional string to customize or override the generated prompt extension.
     :param system_prompt: System prompt to set the context for the LLM.
     :param full_response: If True, returns the full API response including token counts.
+    :param images: A list of image URLs or file paths for vision tasks.
+    :param detail: Level of detail for image analysis ("low", "high", "auto"). OpenAI-specific parameter. Defaults to "auto".
 
-    :return: 
+    :return:
         - If full_response=False: Tuple of (model_object, provider, model_name)
         - If full_response=True: LLMFullResponse object with model_object, provider, and model_name attributes, and input_token_count and output_token_count
         - Error message string if unsuccessful
@@ -287,7 +303,9 @@ async def generate_pydantic_json_model_reliable_async(
                 temperature=temperature,
                 top_p=top_p,
                 json_mode=True,
-                full_response=full_response
+                full_response=full_response,
+                images=images,
+                detail=detail,
             )
             
             if full_response:
@@ -344,6 +362,8 @@ async def generate_pydantic_json_model_async(
     custom_prompt_suffix: str = None,
     system_prompt: str = "The Output is a VALID Structured JSON",
     full_response: bool = False,
+    images: list = None,
+    detail: str = "auto",
 ) -> Union[BaseModel, LLMFullResponse, str]:
     """
     Asynchronously generates a model instance based on a given prompt, retrying on validation errors.
@@ -359,8 +379,10 @@ async def generate_pydantic_json_model_async(
     :param custom_prompt_suffix: Optional string to customize or override the generated prompt extension.
     :param system_prompt: System prompt to set the context for the LLM.
     :param full_response: If True, returns the full API response including token counts.
+    :param images: A list of image URLs or file paths for vision tasks.
+    :param detail: Level of detail for image analysis ("low", "high", "auto"). OpenAI-specific parameter. Defaults to "auto".
 
-    :return: 
+    :return:
         - If full_response=False: BaseModel object
         - If full_response=True: LLMFullResponse object with model_object attribute and input_token_count and output_token_count
         - Error message string if unsuccessful
@@ -378,7 +400,9 @@ async def generate_pydantic_json_model_async(
                 temperature=temperature,
                 top_p=top_p,
                 json_mode=True,
-                full_response=full_response
+                full_response=full_response,
+                images=images,
+                detail=detail,
             )
 
             response_text = ai_response.generated_text if full_response else ai_response

{simplerllm-0.3.2.1 → simplerllm-0.3.2.2}/SimplerLLM.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: SimplerLLM
-Version: 0.3.2.1
+Version: 0.3.2.2
 Summary: An easy-to-use Library for interacting with language models.
 Home-page: https://github.com/hassancs91/SimplerLLM
 Author: Hasan Aboul Hasan

{simplerllm-0.3.2.1 → simplerllm-0.3.2.2}/setup.py

@@ -20,7 +20,7 @@ with open("README.md", encoding="utf-8") as f:
 
 setup(
     name="SimplerLLM",
-    version="0.3.2.1",
+    version="0.3.2.2",
     author="Hasan Aboul Hasan",
     author_email="hasan@learnwithhasan.com",
     description="An easy-to-use Library for interacting with language models.",