webscout 7.0__py3-none-any.whl → 7.2__py3-none-any.whl

webscout/Provider/TTS/voicepod.py

@@ -1,117 +1,117 @@
-import requests
-import json
-import time
-from pathlib import Path
-from typing import Generator
-from playsound import playsound
-from webscout import exceptions
-from webscout.AIbase import TTSProvider
-
-class Voicepods(TTSProvider):
-    """
-    A class to interact with the Voicepods text-to-speech API.
-    """
-
-    def __init__(self, timeout: int = 20, proxies: dict = None):
-        """
-        Initializes the Voicepods API client.
-        """
-        self.api_endpoint = "https://voicepods-stream.vercel.app/api/resemble"
-        self.headers = {
-            'Accept': '*/*',
-            'Accept-Encoding': 'gzip, deflate, br, zstd',
-            'Accept-Language': 'en-US,en;q=0.9,en-IN;q=0.8',
-            'Content-Type': 'application/json',
-            'DNT': '1',
-            'Origin': 'https://voicepods-stream.vercel.app',
-            'Referer': 'https://voicepods-stream.vercel.app/',
-            'Sec-CH-UA': '"Chromium";v="128", "Not;A=Brand";v="24", "Microsoft Edge";v="128"',
-            'Sec-CH-UA-Mobile': '?0',
-            'Sec-CH-UA-Platform': '"Windows"',
-            'Sec-Fetch-Dest': 'empty',
-            'Sec-Fetch-Mode': 'cors',
-            'Sec-Fetch-Site': 'same-origin',
-            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36 Edg/128.0.0.0',
-        }
-        self.session = requests.Session()
-        self.session.headers.update(self.headers)
-        if proxies:
-            self.session.proxies.update(proxies)
-        self.timeout = timeout
-        self.audio_cache_dir = Path("./audio_cache")
-
-    def tts(self, text: str) -> str:
-        """
-        Converts text to speech using the Voicepods API. 
-
-        Args:
-            text (str): The text to be converted to speech.
-
-        Returns:
-            str: The filename of the saved audio file.
-        
-        Raises:
-            exceptions.FailedToGenerateResponseError: If there is an error generating or saving the audio.
-        """
-        payload = json.dumps({"query": text})
-        filename = self.audio_cache_dir / f"{int(time.time())}.wav"  # Using timestamp for filename
-
-        try:
-            response = self.session.post(self.api_endpoint, data=payload, timeout=self.timeout)
-            response.raise_for_status()
-
-            content_type = response.headers.get('Content-Type', '')
-            if 'audio' not in content_type.lower():
-                raise ValueError(f"Unexpected content type: {content_type}")
-
-            audio_data = response.content
-            self._save_audio(audio_data, filename)
-            return filename.as_posix()  # Return the filename as a string
-
-        except requests.exceptions.RequestException as e:
-            raise exceptions.FailedToGenerateResponseError(f"Error generating audio: {e}")
-
-    def _save_audio(self, audio_data: bytes, filename: Path):
-        """Saves the audio data to a WAV file in the audio cache directory."""
-        try:
-            # Create the audio_cache directory if it doesn't exist
-            self.audio_cache_dir.mkdir(parents=True, exist_ok=True)
-
-            riff_start = audio_data.find(b'RIFF')
-            if riff_start == -1:
-                raise ValueError("RIFF header not found in audio data")
-            
-            trimmed_audio_data = audio_data[riff_start:]
-
-            with open(filename, "wb") as f:
-                f.write(trimmed_audio_data)
-
-        except Exception as e:
-            raise exceptions.FailedToGenerateResponseError(f"Error saving audio: {e}")
-
-    def play_audio(self, filename: str):
-        """
-        Plays an audio file using playsound.
-
-        Args:
-            filename (str): The path to the audio file.
-
-        Raises:
-            RuntimeError: If there is an error playing the audio.
-        """
-        try:
-            playsound(filename)
-        except Exception as e:
-            raise RuntimeError(f"Error playing audio: {e}")
-
-# Example usage
-if __name__ == "__main__":
-
-    voicepods = Voicepods()
-    text = "Hello, this is a test of the Voicepods text-to-speech system."
-
-    print("Generating audio...")
-    audio_file = voicepods.tts(text)
-
-    print("Playing audio...")
+import requests
+import json
+import time
+from pathlib import Path
+from typing import Generator
+from playsound import playsound
+from webscout import exceptions
+from webscout.AIbase import TTSProvider
+
+class Voicepods(TTSProvider):
+    """
+    A class to interact with the Voicepods text-to-speech API.
+    """
+
+    def __init__(self, timeout: int = 20, proxies: dict = None):
+        """
+        Initializes the Voicepods API client.
+        """
+        self.api_endpoint = "https://voicepods-stream.vercel.app/api/resemble"
+        self.headers = {
+            'Accept': '*/*',
+            'Accept-Encoding': 'gzip, deflate, br, zstd',
+            'Accept-Language': 'en-US,en;q=0.9,en-IN;q=0.8',
+            'Content-Type': 'application/json',
+            'DNT': '1',
+            'Origin': 'https://voicepods-stream.vercel.app',
+            'Referer': 'https://voicepods-stream.vercel.app/',
+            'Sec-CH-UA': '"Chromium";v="128", "Not;A=Brand";v="24", "Microsoft Edge";v="128"',
+            'Sec-CH-UA-Mobile': '?0',
+            'Sec-CH-UA-Platform': '"Windows"',
+            'Sec-Fetch-Dest': 'empty',
+            'Sec-Fetch-Mode': 'cors',
+            'Sec-Fetch-Site': 'same-origin',
+            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36 Edg/128.0.0.0',
+        }
+        self.session = requests.Session()
+        self.session.headers.update(self.headers)
+        if proxies:
+            self.session.proxies.update(proxies)
+        self.timeout = timeout
+        self.audio_cache_dir = Path("./audio_cache")
+
+    def tts(self, text: str) -> str:
+        """
+        Converts text to speech using the Voicepods API. 
+
+        Args:
+            text (str): The text to be converted to speech.
+
+        Returns:
+            str: The filename of the saved audio file.
+        
+        Raises:
+            exceptions.FailedToGenerateResponseError: If there is an error generating or saving the audio.
+        """
+        payload = json.dumps({"query": text})
+        filename = self.audio_cache_dir / f"{int(time.time())}.wav"  # Using timestamp for filename
+
+        try:
+            response = self.session.post(self.api_endpoint, data=payload, timeout=self.timeout)
+            response.raise_for_status()
+
+            content_type = response.headers.get('Content-Type', '')
+            if 'audio' not in content_type.lower():
+                raise ValueError(f"Unexpected content type: {content_type}")
+
+            audio_data = response.content
+            self._save_audio(audio_data, filename)
+            return filename.as_posix()  # Return the filename as a string
+
+        except requests.exceptions.RequestException as e:
+            raise exceptions.FailedToGenerateResponseError(f"Error generating audio: {e}")
+
+    def _save_audio(self, audio_data: bytes, filename: Path):
+        """Saves the audio data to a WAV file in the audio cache directory."""
+        try:
+            # Create the audio_cache directory if it doesn't exist
+            self.audio_cache_dir.mkdir(parents=True, exist_ok=True)
+
+            riff_start = audio_data.find(b'RIFF')
+            if riff_start == -1:
+                raise ValueError("RIFF header not found in audio data")
+            
+            trimmed_audio_data = audio_data[riff_start:]
+
+            with open(filename, "wb") as f:
+                f.write(trimmed_audio_data)
+
+        except Exception as e:
+            raise exceptions.FailedToGenerateResponseError(f"Error saving audio: {e}")
+
+    def play_audio(self, filename: str):
+        """
+        Plays an audio file using playsound.
+
+        Args:
+            filename (str): The path to the audio file.
+
+        Raises:
+            RuntimeError: If there is an error playing the audio.
+        """
+        try:
+            playsound(filename)
+        except Exception as e:
+            raise RuntimeError(f"Error playing audio: {e}")
+
+# Example usage
+if __name__ == "__main__":
+
+    voicepods = Voicepods()
+    text = "Hello, this is a test of the Voicepods text-to-speech system."
+
+    print("Generating audio...")
+    audio_file = voicepods.tts(text)
+
+    print("Playing audio...")
     voicepods.play_audio(audio_file)

webscout/Provider/TextPollinationsAI.py

@@ -1,41 +1,28 @@
+
 import requests
 import json
 from typing import Any, Dict, Generator
-
-from webscout.AIutel import Optimizers
-from webscout.AIutel import Conversation
-from webscout.AIutel import AwesomePrompts
+from webscout.AIutel import Optimizers, Conversation, AwesomePrompts
 from webscout.AIbase import Provider
 from webscout import exceptions
-
-
+from webscout.Litlogger import Logger, LogFormat
+from webscout import LitAgent as Lit
 class TextPollinationsAI(Provider):
     """
-    A class to interact with the Pollinations AI API.
+    A class to interact with the Pollinations AI API with comprehensive logging.
     """
 
     AVAILABLE_MODELS = [
-        "openai",
-        "openai-large",
-        "qwen",
-        "qwen-coder",
-        "llama",
-        "mistral",
-        "unity",
-        "midijourney",
-        "rtist",
-        "searchgpt",
-        "evil",
-        "deepseek",
-        "claude-hybridspace",
-        "deepseek-r1",
-        "llamalight"
+        "openai", "openai-large", "qwen", "qwen-coder", "llama", "mistral",
+        "unity", "midijourney", "rtist", "searchgpt", "evil", "deepseek",
+        "claude-hybridspace", "deepseek-r1", "llamalight", "llamaguard",
+        "gemini", "gemini-thinking", "hormoz"
     ]
 
     def __init__(
         self,
         is_conversation: bool = True,
-        max_tokens: int = 600,
+        max_tokens: int = 8096,
         timeout: int = 30,
         intro: str = None,
         filepath: str = None,
@@ -43,13 +30,22 @@ class TextPollinationsAI(Provider):
         proxies: dict = {},
         history_offset: int = 10250,
         act: str = None,
-        model: str = "openai",
+        model: str = "openai-large",
         system_prompt: str = "You are a helpful AI assistant.",
+        logging: bool = False
     ):
-        """Initializes the TextPollinationsAI API client."""
+        """Initializes the TextPollinationsAI API client with logging capabilities."""
         if model not in self.AVAILABLE_MODELS:
             raise ValueError(f"Invalid model: {model}. Choose from: {self.AVAILABLE_MODELS}")
 
+        self.logger = Logger(
+            name="TextPollinationsAI",
+            format=LogFormat.MODERN_EMOJI,
+        ) if logging else None
+
+        if self.logger:
+            self.logger.info(f"Initializing TextPollinationsAI with model: {model}")
+
         self.session = requests.Session()
         self.is_conversation = is_conversation
         self.max_tokens_to_sample = max_tokens
@@ -59,20 +55,22 @@ class TextPollinationsAI(Provider):
         self.last_response = {}
         self.model = model
         self.system_prompt = system_prompt
+        
         self.headers = {
             'Accept': '*/*',
             'Accept-Language': 'en-US,en;q=0.9',
-            'User-Agent': 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36',
+            'User-Agent': Lit().random(),
             'Content-Type': 'application/json',
         }
+        
         self.session.headers.update(self.headers)
         self.session.proxies = proxies
 
         self.__available_optimizers = (
-            method
-            for method in dir(Optimizers)
+            method for method in dir(Optimizers)
             if callable(getattr(Optimizers, method)) and not method.startswith("__")
         )
+
         Conversation.intro = (
             AwesomePrompts().get_act(
                 act, raise_not_found=True, default=None, case_insensitive=True
@@ -80,11 +78,15 @@ class TextPollinationsAI(Provider):
             if act
             else intro or Conversation.intro
         )
+
         self.conversation = Conversation(
             is_conversation, self.max_tokens_to_sample, filepath, update_file
         )
         self.conversation.history_offset = history_offset
 
+        if self.logger:
+            self.logger.info("TextPollinationsAI initialized successfully")
+
     def ask(
         self,
         prompt: str,
@@ -93,26 +95,23 @@ class TextPollinationsAI(Provider):
         optimizer: str = None,
         conversationally: bool = False,
     ) -> Dict[str, Any] | Generator[Dict[str, Any], None, None]:
-        """Chat with AI
-        Args:
-            prompt (str): Prompt to be sent.
-            stream (bool, optional): Flag for streaming response. Defaults to False.
-            raw (bool, optional): Stream back raw response as received. Defaults to False.
-            optimizer (str, optional): Prompt optimizer name - `[code, shell_command]`. Defaults to None.
-            conversationally (bool, optional): Chat conversationally when using optimizer. Defaults to False.
-        Returns:
-            Union[Dict, Generator[Dict, None, None]]: Response generated
-        """
+        """Chat with AI with logging capabilities"""
+        if self.logger:
+            self.logger.debug(f"Processing request - Prompt: {prompt[:50]}...")
+            self.logger.debug(f"Stream: {stream}, Optimizer: {optimizer}")
+
         conversation_prompt = self.conversation.gen_complete_prompt(prompt)
         if optimizer:
             if optimizer in self.__available_optimizers:
                 conversation_prompt = getattr(Optimizers, optimizer)(
                     conversation_prompt if conversationally else prompt
                 )
+                if self.logger:
+                    self.logger.debug(f"Applied optimizer: {optimizer}")
             else:
-                raise Exception(
-                    f"Optimizer is not one of {self.__available_optimizers}"
-                )
+                if self.logger:
+                    self.logger.error(f"Invalid optimizer requested: {optimizer}")
+                raise Exception(f"Optimizer is not one of {self.__available_optimizers}")
 
         payload = {
             "messages": [
@@ -124,26 +123,40 @@ class TextPollinationsAI(Provider):
         }
 
         def for_stream():
+            if self.logger:
+                self.logger.debug("Initiating streaming request to API")
+
             response = self.session.post(
-                self.api_endpoint, headers=self.headers, json=payload, stream=True, timeout=self.timeout
+                self.api_endpoint,
+                headers=self.headers,
+                json=payload,
+                stream=True,
+                timeout=self.timeout
             )
+
             if not response.ok:
+                if self.logger:
+                    self.logger.error(f"API request failed. Status: {response.status_code}, Reason: {response.reason}")
                 raise exceptions.FailedToGenerateResponseError(
                     f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
                 )
+
+            if self.logger:
+                self.logger.info(f"API connection established successfully. Status: {response.status_code}")
+
             full_response = ""
             for line in response.iter_lines():
                 if line:
                     line = line.decode('utf-8').strip()
-                    # Break if the stream signals completion
                     if line == "data: [DONE]":
+                        if self.logger:
+                            self.logger.debug("Stream completed")
                         break
                     if line.startswith('data: '):
                         try:
                             json_data = json.loads(line[6:])
                             if 'choices' in json_data and len(json_data['choices']) > 0:
                                 choice = json_data['choices'][0]
-                                # Handle delta responses from streaming output
                                 if 'delta' in choice and 'content' in choice['delta']:
                                     content = choice['delta']['content']
                                 else:
@@ -151,13 +164,21 @@ class TextPollinationsAI(Provider):
                                 full_response += content
                                 yield content if raw else dict(text=content)
                         except json.JSONDecodeError as e:
-                            print(f"Error parsing line: {line} - {e}")
+                            if self.logger:
+                                self.logger.error(f"JSON parsing error: {str(e)}")
+                            continue
+
             self.last_response.update(dict(text=full_response))
             self.conversation.update_chat_history(
                 prompt, self.get_message(self.last_response)
             )
 
+            if self.logger:
+                self.logger.debug("Response processing completed")
+
         def for_non_stream():
+            if self.logger:
+                self.logger.debug("Processing non-streaming request")
             for _ in for_stream():
                 pass
             return self.last_response
@@ -171,12 +192,16 @@ class TextPollinationsAI(Provider):
         optimizer: str = None,
         conversationally: bool = False,
     ) -> str | Generator[str, None, None]:
-        """Generate response as a string"""
+        """Generate response as a string with logging"""
+        if self.logger:
+            self.logger.debug(f"Chat request initiated - Prompt: {prompt[:50]}...")
+
         def for_stream():
             for response in self.ask(
                 prompt, True, optimizer=optimizer, conversationally=conversationally
             ):
                 yield self.get_message(response)
+
         def for_non_stream():
             return self.get_message(
                 self.ask(
@@ -186,6 +211,7 @@ class TextPollinationsAI(Provider):
                     conversationally=conversationally,
                 )
             )
+
         return for_stream() if stream else for_non_stream()
 
     def get_message(self, response: dict) -> str:
@@ -195,7 +221,8 @@ class TextPollinationsAI(Provider):
 
 if __name__ == "__main__":
     from rich import print
-    ai = TextPollinationsAI(model="openai")
+    # Enable logging for testing
+    ai = TextPollinationsAI(model="deepseek-r1", logging=True)
     response = ai.chat(input(">>> "), stream=True)
     for chunk in response:
         print(chunk, end="", flush=True)

webscout/Provider/WiseCat.py

@@ -0,0 +1,193 @@
+import requests
+import json
+from typing import Any, Dict, Generator, Optional
+
+from webscout.AIutel import Optimizers
+from webscout.AIutel import Conversation
+from webscout.AIutel import AwesomePrompts
+from webscout.AIbase import Provider
+from webscout import exceptions
+from webscout import LitAgent
+from webscout import Logger
+from webscout import LogFormat
+
+
+
+class WiseCat(Provider):
+    """
+    A class to interact with the WiseCat API.
+    """
+
+    AVAILABLE_MODELS = [
+        "chat-model-small",
+        "chat-model-large",
+        "chat-model-reasoning",
+    ]
+
+    def __init__(
+        self,
+        is_conversation: bool = True,
+        max_tokens: int = 600,
+        timeout: int = 30,
+        intro: str = None,
+        filepath: str = None,
+        update_file: bool = True,
+        proxies: dict = {},
+        history_offset: int = 10250,
+        act: str = None,
+        model: str = "chat-model-large",
+        system_prompt: str = "You are a helpful AI assistant.",
+        logging: bool = False,
+    ):
+        """Initializes the WiseCat API client."""
+
+        if model not in self.AVAILABLE_MODELS:
+            raise ValueError(f"Invalid model: {model}. Choose from: {self.AVAILABLE_MODELS}")
+
+        self.session = requests.Session()
+        self.is_conversation = is_conversation
+        self.max_tokens_to_sample = max_tokens
+        self.api_endpoint = "https://wise-cat-groq.vercel.app/api/chat"
+        self.stream_chunk_size = 64
+        self.timeout = timeout
+        self.last_response = {}
+        self.model = model
+        self.system_prompt = system_prompt
+        self.headers = {
+            "Content-Type": "application/json",
+            "Accept": "*/*",
+            "User-Agent": LitAgent().random()
+        }
+        self.session.headers.update(self.headers)
+        self.session.proxies = proxies
+
+        # Initialize logger
+        self.logger = Logger(name="WISECAT", format=LogFormat.MODERN_EMOJI) if logging else None
+
+        self.__available_optimizers = (
+            method
+            for method in dir(Optimizers)
+            if callable(getattr(Optimizers, method)) and not method.startswith("__")
+        )
+        Conversation.intro = (
+            AwesomePrompts().get_act(
+                act, raise_not_found=True, default=None, case_insensitive=True
+            )
+            if act
+            else intro or Conversation.intro
+        )
+        self.conversation = Conversation(
+            is_conversation, self.max_tokens_to_sample, filepath, update_file
+        )
+        self.conversation.history_offset = history_offset
+
+    def ask(
+        self,
+        prompt: str,
+        stream: bool = False,
+        raw: bool = False,
+        optimizer: str = None,
+        conversationally: bool = False,
+    ) -> Dict[str, Any] | Generator[Dict[str, Any], None, None]:
+        """Chat with AI"""
+        if self.logger:
+            self.logger.debug(f"ask() called with prompt: {prompt}")
+
+        conversation_prompt = self.conversation.gen_complete_prompt(prompt)
+        if optimizer:
+            if optimizer in self.__available_optimizers:
+                conversation_prompt = getattr(Optimizers, optimizer)(
+                    conversation_prompt if conversationally else prompt
+                )
+            else:
+                if self.logger:
+                    self.logger.error(f"Invalid optimizer: {optimizer}")
+                raise Exception(
+                    f"Optimizer is not one of {self.__available_optimizers}"
+                )
+
+        payload = {
+            "id": "ephemeral",
+            "messages": [
+                {
+                    "role": "system",
+                    "content": self.system_prompt
+                },
+                {
+                    "role": "user",
+                    "content": conversation_prompt,
+                }
+            ],
+            "selectedChatModel": self.model
+        }
+
+        def for_stream():
+            response = self.session.post(
+                self.api_endpoint, headers=self.headers, json=payload, stream=True, timeout=self.timeout
+            )
+            if not response.ok:
+                error_msg = f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
+                if self.logger:
+                    self.logger.error(error_msg)
+                raise exceptions.FailedToGenerateResponseError(error_msg)
+
+            streaming_response = ""
+            for line in response.iter_lines(decode_unicode=True):
+                if line:
+                    if line.startswith("0:"):
+                        content = line[2:].strip('"')
+                        streaming_response += content
+                        yield content if raw else dict(text=content)
+            
+            self.last_response.update(dict(text=streaming_response))
+            self.conversation.update_chat_history(
+                prompt, self.get_message(self.last_response)
+            )
+
+        def for_non_stream():
+            for _ in for_stream():
+                pass
+            return self.last_response
+
+        return for_stream() if stream else for_non_stream()
+
+    def chat(
+        self,
+        prompt: str,
+        stream: bool = False,
+        optimizer: str = None,
+        conversationally: bool = False,
+    ) -> str:
+        """Generate response `str`"""
+        if self.logger:
+            self.logger.debug(f"chat() called with prompt: {prompt}")
+
+        def for_stream():
+            for response in self.ask(
+                prompt, True, optimizer=optimizer, conversationally=conversationally
+            ):
+                yield self.get_message(response)
+
+        def for_non_stream():
+            return self.get_message(
+                self.ask(
+                    prompt,
+                    False,
+                    optimizer=optimizer,
+                    conversationally=conversationally,
+                )
+            )
+
+        return for_stream() if stream else for_non_stream()
+
+    def get_message(self, response: dict) -> str:
+        """Retrieves message only from response"""
+        assert isinstance(response, dict), "Response should be of dict data-type only"
+        return response["text"]
+
+if __name__ == "__main__":
+    from rich import print
+    ai = WiseCat()
+    response = ai.chat(input(">>> "))
+    for chunk in response:
+        print(chunk, end="", flush=True)