lollms-client 0.11.0__py3-none-any.whl → 0.12.1__py3-none-any.whl

lollms_client/tts_bindings/lollms/__init__.py

@@ -0,0 +1,145 @@
+# lollms_client/tts_bindings/lollms/__init__.py
+import requests
+from lollms_client.lollms_tts_binding import LollmsTTSBinding
+from typing import Optional, List
+from ascii_colors import trace_exception, ASCIIColors
+import json
+
+# Defines the binding name for the manager
+BindingName = "LollmsTTSBinding_Impl"
+
+class LollmsTTSBinding_Impl(LollmsTTSBinding):
+    """Concrete implementation of the LollmsTTSBinding for the standard LOLLMS server."""
+
+    def __init__(self,
+                 host_address: Optional[str] = "http://localhost:9600",
+                 model_name: Optional[str] = "main_voice",
+                 service_key: Optional[str] = None, # This will be used as client_id
+                 verify_ssl_certificate: bool = True):
+        """
+        Initialize the LOLLMS TTS binding.
+
+        Args:
+            host_address (Optional[str]): Host address for the LOLLMS service.
+            model_name (Optional[str]): Default voice/model name to use.
+            service_key (Optional[str]): Authentication key, used as client_id for LOLLMS server.
+            verify_ssl_certificate (bool): Whether to verify SSL certificates.
+        """
+        super().__init__(host_address=host_address,
+                         model_name=model_name,
+                         service_key=service_key, # Stored in the parent class
+                         verify_ssl_certificate=verify_ssl_certificate)
+        # self.client_id = service_key # Can access via self.service_key from parent
+
+    def generate_audio(self, text: str, voice: Optional[str] = None, **kwargs) -> bytes:
+        """
+        Generates audio data from text using the LOLLMS /text2Audio endpoint.
+
+        Args:
+            text (str): The text content to synthesize.
+            voice (Optional[str]): The specific voice to use. If None, uses the default from init.
+            **kwargs: Accepts 'fn' (filename) for server-side saving,
+                      and 'client_id' to override the instance's default client_id.
+
+        Returns:
+            bytes: Returns an empty bytes string as the server saves the file and returns status JSON.
+
+        Raises:
+            Exception: If the request fails or the server returns an error status.
+            ValueError: If client_id is not available.
+        """
+        endpoint = f"{self.host_address}/text2Audio"
+        voice_to_use = voice if voice else self.model_name
+        filename_on_server = kwargs.get("fn")
+        
+        # Determine client_id: use from kwargs if provided, otherwise from instance's service_key
+        client_id_to_use = kwargs.get("client_id", self.service_key)
+        if not client_id_to_use:
+            # Fallback or raise error if client_id is strictly required by the server
+            # For /text2Audio, it is strictly required.
+            raise ValueError("client_id is required for text2Audio but was not provided during LollmsClient initialization (as service_key) or in this call.")
+
+
+        request_data = {
+            "client_id": client_id_to_use, # ADDED client_id
+            "text": text,
+            "voice": voice_to_use,
+            "fn": filename_on_server
+        }
+        # Filter out None values for 'voice' and 'fn' if the server doesn't expect them or handles defaults
+        # client_id and text are mandatory for the server model LollmsText2AudioRequest
+        if voice_to_use is None:
+            del request_data["voice"]
+        if filename_on_server is None:
+            del request_data["fn"]
+
+
+        headers = {'Content-Type': 'application/json'}
+        # service_key (if different from client_id for auth header) isn't used by this endpoint's auth
+        # The check_access on server side uses the client_id from the payload.
+
+        try:
+            ASCIIColors.debug(f"Sending TTS request to {endpoint} with payload: {request_data}")
+            response = requests.post(endpoint, json=request_data, headers=headers, verify=self.verify_ssl_certificate)
+            response.raise_for_status()
+            
+            response_json = response.json()
+            if response_json.get("status") is False or "error" in response_json: # Check for explicit error
+                 raise Exception(f"Server returned error: {response_json.get('error', 'Unknown error')}")
+
+            ASCIIColors.info(f"Audio generation requested. Server response: {response_json}")
+            return b""
+
+        except requests.exceptions.HTTPError as e:
+            # Log the response content for 422 errors specifically
+            if e.response is not None and e.response.status_code == 422:
+                try:
+                    error_details = e.response.json()
+                    ASCIIColors.error(f"Unprocessable Entity. Server details: {error_details}")
+                except json.JSONDecodeError:
+                    ASCIIColors.error(f"Unprocessable Entity. Server response: {e.response.text}")
+            trace_exception(e)
+            raise Exception(f"HTTP request failed: {e}") from e # Re-raise the original HTTPError
+        except requests.exceptions.RequestException as e:
+            trace_exception(e)
+            raise Exception(f"HTTP request connection failed: {e}") from e
+        except Exception as e:
+            trace_exception(e)
+            raise Exception(f"Audio generation failed: {e}") from e
+
+
+    def list_voices(self, **kwargs) -> List[str]:
+        """
+        Lists the available voices using the LOLLMS /list_voices endpoint.
+        This endpoint does not require client_id in the request body based on server code.
+
+        Args:
+            **kwargs: Additional parameters (currently unused).
+
+        Returns:
+            List[str]: A list of available voice identifiers. Returns ["main_voice"] on failure.
+        """
+        endpoint = f"{self.host_address}/list_voices"
+        headers = {'Content-Type': 'application/json'}
+        # No client_id needed in payload for this specific GET endpoint on the server
+
+        try:
+            response = requests.get(endpoint, headers=headers, verify=self.verify_ssl_certificate)
+            response.raise_for_status()
+            voices_data = response.json()
+            if "error" in voices_data or voices_data.get("status") is False:
+                 ASCIIColors.error(f"Error listing voices from server: {voices_data.get('error', 'Unknown server error')}")
+                 return ["main_voice"]
+            return voices_data.get("voices", ["main_voice"])
+        except requests.exceptions.RequestException as e:
+            ASCIIColors.error(f"Couldn't list voices due to connection error: {e}")
+            trace_exception(e)
+            return ["main_voice"]
+        except json.JSONDecodeError as e:
+            ASCIIColors.error(f"Couldn't parse voices response from server: {e}")
+            trace_exception(e)
+            return ["main_voice"]
+        except Exception as e:
+            ASCIIColors.error(f"An unexpected error occurred while listing voices: {e}")
+            trace_exception(e)
+            return ["main_voice"]

lollms_client/ttv_bindings/__init__.py

@@ -0,0 +1,73 @@
+# lollms_client/ttv_bindings/lollms/__init__.py
+import requests
+from lollms_client.lollms_ttv_binding import LollmsTTVBinding
+from typing import Optional, List
+from ascii_colors import trace_exception, ASCIIColors
+
+# Defines the binding name for the manager
+BindingName = "LollmsTTVBinding_Impl"
+
+class LollmsTTVBinding_Impl(LollmsTTVBinding):
+    """Concrete implementation of the LollmsTTVBinding for the standard LOLLMS server (Placeholder)."""
+
+    def __init__(self,
+                 host_address: Optional[str] = "http://localhost:9600", # Default LOLLMS host
+                 model_name: Optional[str] = None, # Default model (server decides if None)
+                 service_key: Optional[str] = None,
+                 verify_ssl_certificate: bool = True):
+        """
+        Initialize the LOLLMS TTV binding.
+
+        Args:
+            host_address (Optional[str]): Host address for the LOLLMS service.
+            model_name (Optional[str]): Default TTV model identifier.
+            service_key (Optional[str]): Authentication key.
+            verify_ssl_certificate (bool): Whether to verify SSL certificates.
+        """
+        super().__init__(host_address=host_address,
+                         model_name=model_name,
+                         service_key=service_key,
+                         verify_ssl_certificate=verify_ssl_certificate)
+        ASCIIColors.warning("LOLLMS TTV binding is not yet fully implemented in the client.")
+        ASCIIColors.warning("Please ensure your LOLLMS server has a TTV service running.")
+
+
+    def generate_video(self, prompt: str, **kwargs) -> bytes:
+        """
+        Generates video data using an assumed LOLLMS /generate_video endpoint. (Not Implemented)
+
+        Args:
+            prompt (str): The text prompt describing the desired video.
+            **kwargs: Additional parameters (e.g., duration, fps).
+
+        Returns:
+            bytes: Placeholder empty bytes.
+
+        Raises:
+            NotImplementedError: This method is not yet implemented.
+        """
+        # endpoint = f"{self.host_address}/generate_video" # Assumed endpoint
+        # request_data = {"prompt": prompt, **kwargs}
+        # headers = {'Content-Type': 'application/json'}
+        # ... make request ...
+        # return response.content # Assuming direct bytes response
+        raise NotImplementedError("LOLLMS TTV generate_video client binding is not implemented yet.")
+
+
+    def list_models(self, **kwargs) -> List[str]:
+        """
+        Lists available TTV models using an assumed LOLLMS /list_ttv_models endpoint. (Not Implemented)
+
+        Args:
+            **kwargs: Additional parameters.
+
+        Returns:
+            List[str]: Placeholder empty list.
+
+        Raises:
+            NotImplementedError: This method is not yet implemented.
+        """
+        # endpoint = f"{self.host_address}/list_ttv_models" # Assumed endpoint
+        # ... make request ...
+        # return response.json().get("models", [])
+        raise NotImplementedError("LOLLMS TTV list_models client binding is not implemented yet.")

{lollms_client-0.11.0.dist-info → lollms_client-0.12.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lollms_client
-Version: 0.11.0
+Version: 0.12.1
 Summary: A client library for LoLLMs generate endpoint
 Home-page: https://github.com/ParisNeo/lollms_client
 Author: ParisNeo

lollms_client-0.12.1.dist-info/RECORD

@@ -0,0 +1,41 @@
+lollms_client/__init__.py,sha256=CrU6LzlhPyYQOMDgkw8Dqb3nvWYyZk0HixGF0QyTOWc,501
+lollms_client/lollms_config.py,sha256=goEseDwDxYJf3WkYJ4IrLXwg3Tfw73CXV2Avg45M_hE,21876
+lollms_client/lollms_core.py,sha256=NYUmzYxxMAPyy8OQ5fnPSerzM5IEYxhz598zZdA6Qrg,77772
+lollms_client/lollms_discussion.py,sha256=9b83m0D894jwpgssWYTQHbVxp1gJoI-J947Ui_dRXII,2073
+lollms_client/lollms_functions.py,sha256=p8SFtmEPqvVCsIz2fZ5HxyOHaxjrAo5c12uTzJnb6m8,3594
+lollms_client/lollms_js_analyzer.py,sha256=01zUvuO2F_lnUe_0NLxe1MF5aHE1hO8RZi48mNPv-aw,8361
+lollms_client/lollms_llm_binding.py,sha256=3oyj2GF7x27bCQxM8D1ZkKiEfGKFp0E_Bv5bH_meTMk,8331
+lollms_client/lollms_personality.py,sha256=gTOU7WJrxyNE88g-9-is5QxMf84s6xbEMAv--SD2P64,20313
+lollms_client/lollms_personality_worker.py,sha256=rQbZg9Gn-R3b6x0Ryb4JPWJzBfn4fObDzj5IWYez_9o,65331
+lollms_client/lollms_python_analyzer.py,sha256=7gf1fdYgXCOkPUkBAPNmr6S-66hMH4_KonOMsADASxc,10246
+lollms_client/lollms_stt.py,sha256=4knP8SSj2S7DAFGXpIHc-_J6pb9xjExutEBd0RNex5E,1282
+lollms_client/lollms_stt_binding.py,sha256=ovmpFF0fnmPC9VNi1-rxAJA8xI4JZDUBh_YwdtoTx28,5818
+lollms_client/lollms_tasks.py,sha256=Tgqces03gPTHFJCcPaeN9vBCsil3SSJX7nQAjCQ2-yg,34393
+lollms_client/lollms_tti.py,sha256=WznZ5ADhig-SFNmwlgviLZaAfl67NVqnZxYzhel3vxU,1287
+lollms_client/lollms_tti_binding.py,sha256=CBCdXt6GQzRPzq7eEujQ5mBOoYcqUUdYY-POHLbJhx8,7469
+lollms_client/lollms_ttm_binding.py,sha256=ymGvHtFqesm32y1ZoyIgMBC1PckTABS-DOh-8SvMkRs,5706
+lollms_client/lollms_tts.py,sha256=KjFNkRmpM4kZpHm-IrPoYr4kPs2nOHNKPov0HXiinkg,1468
+lollms_client/lollms_tts_binding.py,sha256=c4PQVe6NyPUtNguKMPo5L2nHJXjoIEQpCtVLK06p_iA,5880
+lollms_client/lollms_ttv_binding.py,sha256=u-gLIe22tbu4YsKA5RTyUT7iBlKxPXDmoQzccG3_KuA,5672
+lollms_client/lollms_types.py,sha256=cfc1sremM8KR4avkYX99fIVkkdRvXErrCWKGjLrgv50,2723
+lollms_client/lollms_utilities.py,sha256=YAgamfp0pBVApR68AHKjhp1lh6isMNF8iadwWLl63c0,7045
+lollms_client/llm_bindings/__init__.py,sha256=9sWGpmWSSj6KQ8H4lKGCjpLYwhnVdL_2N7gXCphPqh4,14
+lollms_client/llm_bindings/lollms/__init__.py,sha256=PRQwXOdqR_nWMvxwcL2u-32YBPDrSdQZRUxkbz3-bBk,11911
+lollms_client/llm_bindings/ollama/__init__.py,sha256=7xZpoRQNptTPlHY9o5BD0xH2yR-b3FcT8wfv-SOWS9Q,12534
+lollms_client/llm_bindings/openai/__init__.py,sha256=8VbJ9EF30w0gTlc9e7gzvTxBfWl0mjNBGlHqUoqQ2eg,10463
+lollms_client/llm_bindings/transformers/__init__.py,sha256=vSzg5OWpiFPPP3GzEfoOs9K7Q0B1n6zCi3-j4M9tkWE,12467
+lollms_client/stt_bindings/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lollms_client/stt_bindings/lollms/__init__.py,sha256=7-IZkrsn15Vaz0oqkqCxMeNQfMkeilbgScLlrrywES4,6098
+lollms_client/tti_bindings/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lollms_client/tti_bindings/lollms/__init__.py,sha256=y1mcAsaYnWUVEw1Wq3Gxur4srwKDWu2IKRgwtsSPifY,9082
+lollms_client/ttm_bindings/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lollms_client/ttm_bindings/lollms/__init__.py,sha256=DU3WLmJaWNM1NAMtJsnaFo4Y9wlfc675M8aUiaLnojA,3143
+lollms_client/tts_bindings/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lollms_client/tts_bindings/lollms/__init__.py,sha256=8x2_T9XscvISw2TiaLoFxvrS7TIsVLdqbwSc04cX-wc,7164
+lollms_client/ttv_bindings/__init__.py,sha256=UZ8o2izQOJLQgtZ1D1cXoNST7rzqW22rL2Vufc7ddRc,3141
+lollms_client/ttv_bindings/lollms/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lollms_client-0.12.1.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
+lollms_client-0.12.1.dist-info/METADATA,sha256=KSlyF6abPll_F4-vU03grmQSpt5yTkW6tnOVD93HbG0,6866
+lollms_client-0.12.1.dist-info/WHEEL,sha256=SmOxYU7pzNKBqASvQJ7DjX3XGUF92lrGhMb3R6_iiqI,91
+lollms_client-0.12.1.dist-info/top_level.txt,sha256=Bk_kz-ri6Arwsk7YG-T5VsRorV66uVhcHGvb_g2WqgE,14
+lollms_client-0.12.1.dist-info/RECORD,,

lollms_client-0.11.0.dist-info/RECORD

@@ -1,34 +0,0 @@
-lollms_client/__init__.py,sha256=tBrrYsu4fpi8ZR5ZzTjY88O0UMv9_tqG--VXGQxK2UU,493
-lollms_client/lollms_config.py,sha256=goEseDwDxYJf3WkYJ4IrLXwg3Tfw73CXV2Avg45M_hE,21876
-lollms_client/lollms_core.py,sha256=EX9G-2hhJNO5kL9DXY_zAvg_R7R_M6IgocXNAd-6-SA,50542
-lollms_client/lollms_discussion.py,sha256=9b83m0D894jwpgssWYTQHbVxp1gJoI-J947Ui_dRXII,2073
-lollms_client/lollms_functions.py,sha256=p8SFtmEPqvVCsIz2fZ5HxyOHaxjrAo5c12uTzJnb6m8,3594
-lollms_client/lollms_js_analyzer.py,sha256=01zUvuO2F_lnUe_0NLxe1MF5aHE1hO8RZi48mNPv-aw,8361
-lollms_client/lollms_llm_binding.py,sha256=aegUdAz_3DwJ1nDmq6lxD6x1bI4c4jVa6IbgdAVyaFE,8233
-lollms_client/lollms_personality.py,sha256=gTOU7WJrxyNE88g-9-is5QxMf84s6xbEMAv--SD2P64,20313
-lollms_client/lollms_personality_worker.py,sha256=rQbZg9Gn-R3b6x0Ryb4JPWJzBfn4fObDzj5IWYez_9o,65331
-lollms_client/lollms_python_analyzer.py,sha256=7gf1fdYgXCOkPUkBAPNmr6S-66hMH4_KonOMsADASxc,10246
-lollms_client/lollms_stt.py,sha256=4knP8SSj2S7DAFGXpIHc-_J6pb9xjExutEBd0RNex5E,1282
-lollms_client/lollms_tasks.py,sha256=Ur-Aaqr3Tm9htlRAI16NKwaVAGkY-_SENhUEikikZwA,34458
-lollms_client/lollms_tti.py,sha256=WznZ5ADhig-SFNmwlgviLZaAfl67NVqnZxYzhel3vxU,1287
-lollms_client/lollms_tts.py,sha256=KjFNkRmpM4kZpHm-IrPoYr4kPs2nOHNKPov0HXiinkg,1468
-lollms_client/lollms_types.py,sha256=cfc1sremM8KR4avkYX99fIVkkdRvXErrCWKGjLrgv50,2723
-lollms_client/lollms_utilities.py,sha256=YAgamfp0pBVApR68AHKjhp1lh6isMNF8iadwWLl63c0,7045
-lollms_client/llm_bindings/__init__.py,sha256=9sWGpmWSSj6KQ8H4lKGCjpLYwhnVdL_2N7gXCphPqh4,14
-lollms_client/llm_bindings/lollms/__init__.py,sha256=lyqvXtIM3CDzY9RrgpxnLdnCknBIR1eYzJ20tqAWsvo,11873
-lollms_client/llm_bindings/ollama/__init__.py,sha256=KLLRmcs9OtGW_H-50kkzKz0e25jKEDh1SkLrb2rvD-4,12496
-lollms_client/llm_bindings/openai/__init__.py,sha256=4JaiqJc3Zszc2T0XQFQBBwI3p5VqZlamLLgangUrHiY,10423
-lollms_client/llm_bindings/transformers/__init__.py,sha256=-tEenmutc5iGoa9kgPBEC998EiQBX7BH6oxMonCmlf8,12423
-lollms_client/stt_bindings/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-lollms_client/stt_bindings/lollms/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-lollms_client/tti_bindings/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-lollms_client/tti_bindings/lollms/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-lollms_client/tts_bindings/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-lollms_client/tts_bindings/lollms/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-lollms_client/ttv_bindings/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-lollms_client/ttv_bindings/lollms/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-lollms_client-0.11.0.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
-lollms_client-0.11.0.dist-info/METADATA,sha256=6MmwdbFZydsbJywBslDtbHg7lc2ZA7Tmdi3n-R7QdtQ,6866
-lollms_client-0.11.0.dist-info/WHEEL,sha256=SmOxYU7pzNKBqASvQJ7DjX3XGUF92lrGhMb3R6_iiqI,91
-lollms_client-0.11.0.dist-info/top_level.txt,sha256=Bk_kz-ri6Arwsk7YG-T5VsRorV66uVhcHGvb_g2WqgE,14
-lollms_client-0.11.0.dist-info/RECORD,,