webscout 6.2b0__py3-none-any.whl → 6.4__py3-none-any.whl

webscout/Provider/llmchat.py

@@ -0,0 +1,203 @@
+import requests
+import json
+from typing import Any, Dict, Optional, Generator, List
+
+from webscout.AIutel import Optimizers
+from webscout.AIutel import Conversation
+from webscout.AIutel import AwesomePrompts
+from webscout.AIbase import Provider
+from webscout import exceptions
+
+class LLMChat(Provider):
+    """
+    A class to interact with the LLMChat API.
+    """
+
+    AVAILABLE_MODELS = [
+        "@cf/meta/llama-3.1-70b-instruct",
+        "@cf/meta/llama-3.1-8b-instruct",
+        "@cf/meta/llama-3.2-3b-instruct",
+        "@cf/meta/llama-3.2-1b-instruct"
+    ]
+
+    def __init__(
+        self,
+        is_conversation: bool = True,
+        max_tokens: int = 2048,
+        timeout: int = 30,
+        intro: str = None,
+        filepath: str = None,
+        update_file: bool = True,
+        proxies: dict = {},
+        history_offset: int = 10250,
+        act: str = None,
+        model: str = "@cf/meta/llama-3.1-70b-instruct",  # Default model
+        system_prompt: str = "You are a helpful assistant.",
+    ):
+        """
+        Initializes the LLMChat API with given parameters.
+        """
+        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://llmchat.in/inference/stream"
+        self.timeout = timeout
+        self.last_response = {}
+        self.model = model
+        self.system_prompt = system_prompt
+        self.headers = {
+            "Content-Type": "application/json",
+            "Accept": "*/*",
+            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0",
+            "Origin": "https://llmchat.in",
+            "Referer": "https://llmchat.in/"
+        }
+        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
+        self.session.proxies = proxies
+
+    def ask(
+        self,
+        prompt: str,
+        stream: bool = False,
+        raw: bool = False,
+        optimizer: str = None,
+        conversationally: bool = False,
+    ) -> Dict[str, Any]:
+        """Chat with LLMChat
+
+        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:
+            dict: Response dictionary.
+        """
+        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:
+                raise exceptions.FailedToGenerateResponseError(
+                    f"Optimizer is not one of {self.__available_optimizers}"
+                )
+
+        url = f"{self.api_endpoint}?model={self.model}"
+        payload = {
+            "messages": [
+                {"role": "system", "content": self.system_prompt},
+                {"role": "user", "content": conversation_prompt}
+            ],
+            "max_tokens": self.max_tokens_to_sample,
+            "stream": stream
+        }
+
+        def for_stream():
+            try:
+                with requests.post(url, json=payload, headers=self.headers, stream=True, timeout=self.timeout) as response:
+                    response.raise_for_status()
+                    full_response = ""
+                    for line in response.iter_lines():
+                        if line:
+                            line = line.decode('utf-8')
+                            if line.startswith('data: '):
+                                try:
+                                    data = json.loads(line[6:])
+                                    if data.get('response'):
+                                        response_text = data['response']
+                                        full_response += response_text
+                                        yield response_text if raw else dict(text=response_text)
+                                except json.JSONDecodeError:
+                                    if line.strip() != 'data: [DONE]':
+                                        print(f"Failed to parse line: {line}")
+                                    continue
+                    self.last_response.update(dict(text=full_response))
+                    self.conversation.update_chat_history(
+                        prompt, self.get_message(self.last_response)
+                    )
+            except requests.exceptions.RequestException as e:
+                raise exceptions.FailedToGenerateResponseError(f"Request failed: {e}")
+        
+        def for_non_stream():
+            full_response = ""
+            for line in for_stream():
+                full_response += line['text'] if not raw else line
+            return dict(text=full_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 | Generator[str, None, None]:
+        """Generate response `str`
+        Args:
+            prompt (str): Prompt to be send.
+            stream (bool, optional): Flag for streaming response. 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:
+            str: Response generated
+        """
+
+        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, Any]) -> str:
+        """Retrieves message only from response.
+
+        Args:
+            response (dict): Response generated by `self.ask`
+
+        Returns:
+            str: Message extracted.
+        """
+        assert isinstance(response, dict), "Response should be of dict data-type only"
+        return response["text"]
+
+
+if __name__ == "__main__":
+    from rich import print
+    ai = LLMChat(model='@cf/meta/llama-3.1-70b-instruct')
+    response = ai.chat("What's the meaning of life?", stream=True)
+    for chunk in response:
+        print(chunk, end="", flush=True)

webscout/Provider/mhystical.py

@@ -0,0 +1,176 @@
+import requests
+import json
+from typing import Any, Dict, Optional, Generator, List
+
+from webscout.AIutel import Optimizers
+from webscout.AIutel import Conversation
+from webscout.AIutel import AwesomePrompts
+from webscout.AIbase import Provider
+from webscout import exceptions
+
+
+class Mhystical(Provider):
+    """
+    A class to interact with the Mhystical API. Improved to meet webscout provider standards.
+    """
+
+    AVAILABLE_MODELS = ["gpt-4", "gpt-3.5-turbo"]  # Add available models
+
+    def __init__(
+        self,
+        is_conversation: bool = True,
+        max_tokens: int = 2048,
+        timeout: int = 30,
+        intro: str = None,
+        filepath: str = None,
+        update_file: bool = True,
+        proxies: dict = {},
+        history_offset: int = 10250,
+        act: str = None,
+        model: str = "gpt-4", # Default model
+        system_prompt: str = "You are a helpful AI assistant." # Default system prompt
+    ):
+        """Initializes the Mhystical API."""
+        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://api.mhystical.cc/v1/completions"
+        self.timeout = timeout
+        self.last_response = {}
+        self.model = model
+        self.system_prompt = system_prompt # Store system prompt
+        self.headers = {
+            "x-api-key": "mhystical", # Set API key in header (or better, in __init__ from parameter)
+            "Content-Type": "application/json",
+            "accept": "*/*",
+            "user-agent": "Mozilla/5.0"
+        }
+        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
+        self.session.proxies = proxies
+
+
+    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]:
+
+        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:
+                raise exceptions.FailedToGenerateResponseError(
+                    f"Optimizer is not one of {self.__available_optimizers}"
+                )
+
+        messages = [
+                {"role": "system", "content": self.system_prompt},  # Include system prompt
+                {"role": "user", "content": conversation_prompt},
+            ]
+            
+        data = {
+            "model": self.model,  # Now using self.model
+            "messages": messages # Pass messages to API
+        }
+
+        def for_stream():
+            try:
+                with requests.post(self.api_endpoint, headers=self.headers, json=data, stream=True, timeout=self.timeout) as response:
+                    response.raise_for_status() # Raise exceptions for HTTP errors
+
+                    # Emulate streaming for this API
+                    full_response = ""  # Accumulate the full response
+                    for chunk in response.iter_content(decode_unicode=True, chunk_size=self.stream_chunk_size):
+                        if chunk:
+                            full_response += chunk
+                            yield chunk if raw else {"text": chunk}
+
+                    self.last_response.update({"text": full_response})
+                    self.conversation.update_chat_history(prompt, full_response)
+            except requests.exceptions.RequestException as e:
+                raise exceptions.ProviderConnectionError(f"Network error: {str(e)}")
+
+        def for_non_stream():
+            try:
+                response = self.session.post(self.api_endpoint, headers=self.headers, json=data, timeout=self.timeout)
+                response.raise_for_status()
+
+                full_response = self._parse_response(response.text)
+                self.last_response.update({"text": full_response})
+
+                # Yield the entire response as a single chunk
+                yield {"text": full_response}
+
+            except requests.exceptions.RequestException as e:
+                raise exceptions.ProviderConnectionError(f"Network error: {str(e)}")
+
+        return for_stream() if stream else for_non_stream()
+
+
+
+    def chat(
+        self,
+        prompt: str,
+        stream: bool = False,
+        optimizer: str = None,
+        conversationally: bool = False,
+    ) -> str | Generator[str, None, None]:
+
+        def for_stream():
+            for response in self.ask(
+                prompt, stream=True, optimizer=optimizer, conversationally=conversationally
+            ):
+                yield self.get_message(response)
+
+        def for_non_stream():
+            response = next(self.ask(
+                prompt, stream=False, optimizer=optimizer, conversationally=conversationally
+            ))
+            return self.get_message(response)
+        return for_stream() if stream else for_non_stream()
+
+
+
+    def get_message(self, response: dict) -> str:
+        assert isinstance(response, dict), "Response should be of dict data-type only"
+        return response["text"]
+
+    @staticmethod
+    def _parse_response(response_text: str) -> str:
+        """Parse and validate API response."""
+        try:
+            data = json.loads(response_text)
+            return data["choices"][0]["message"]["content"].strip()
+        except (json.JSONDecodeError, KeyError, IndexError) as e:
+            raise exceptions.InvalidResponseError(f"Failed to parse response: {str(e)}")
+
+if __name__ == "__main__":
+    from rich import print
+    ai = Mhystical()
+    response = ai.chat(input(">>> "))
+    for chunk in response:
+        print(chunk, end="", flush=True)

webscout/Provider/perplexitylabs.py

@@ -0,0 +1,265 @@
+import json
+import random
+import requests
+import websocket
+from typing import Generator, Union, Optional, Dict, Any
+
+from webscout.AIutel import Optimizers
+from webscout.AIutel import Conversation
+from webscout.AIutel import AwesomePrompts
+from webscout.AIbase import Provider
+from webscout import exceptions
+
+API_URL = "https://www.perplexity.ai/socket.io/"
+WS_URL = "wss://www.perplexity.ai/socket.io/"
+
+class PerplexityLabs(Provider):
+    """
+    A class to interact with the Perplexity Labs API
+    """
+    url = "https://labs.perplexity.ai"
+
+    # Models with web search capability
+    online_models = [
+        "llama-3.1-sonar-large-128k-online",
+        "llama-3.1-sonar-small-128k-online",
+    ]
+
+    # Models for chat/instruct without web search
+    chat_models = [
+        "llama-3.1-sonar-large-128k-chat",
+        "llama-3.1-sonar-small-128k-chat",
+        "llama-3.1-8b-instruct",
+        "llama-3.1-70b-instruct",
+    ]
+
+    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 = "llama-3.1-sonar-large-128k-online",  
+        system_prompt: str = "You are a helpful AI assistant.",
+    ):
+        """Initializes the PerplexityLabs API client."""
+        self.session = requests.Session()
+        self.is_conversation = is_conversation
+        self.max_tokens_to_sample = max_tokens
+        self.timeout = timeout
+        self.last_response = {}
+        self.system_prompt = system_prompt
+        self.headers = {
+            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+            "Accept": "*/*",
+            "Accept-Language": "en-US,en;q=0.9",
+            "Accept-Encoding": "gzip, deflate, br",
+            "Origin": self.url,
+            "Connection": "keep-alive",
+            "Referer": f"{self.url}/",
+            "Sec-Fetch-Dest": "empty",
+            "Sec-Fetch-Mode": "cors",
+            "Sec-Fetch-Site": "same-site",
+            "Pragma": "no-cache",
+            "Cache-Control": "no-cache",
+        }
+        self.session.headers.update(self.headers)
+        self.proxies = proxies
+        self.model = model
+        self.conversation = Conversation(is_conversation, max_tokens, filepath, update_file)
+        self.conversation.history_offset = history_offset
+        self.__available_optimizers = ["gpt4", "claude", "gemini", "simple"]
+        
+        try:
+            self.session.get(self.url)
+        except requests.exceptions.RequestException as e:
+            raise exceptions.ProviderConnectionError(f"Failed to initialize session: {e}")
+
+
+    def _get_session_id(self) -> str:
+        t = format(random.getrandbits(32), "08x")
+        try:
+            response = self.session.get(
+                f"{API_URL}?EIO=4&transport=polling&t={t}",
+                proxies=self.proxies
+            )
+            response.raise_for_status()
+            text = response.text
+            
+            if not text.startswith("0"):
+                raise exceptions.InvalidResponseError("Invalid response format")
+            
+            return json.loads(text[1:])["sid"]
+        except requests.exceptions.RequestException as e:
+            raise exceptions.ProviderConnectionError(f"Failed to get session ID: {e}")
+        except (json.JSONDecodeError, KeyError) as e:
+            raise exceptions.InvalidResponseError(f"Failed to parse session ID: {e}")
+
+
+    def _authenticate_session(self, sid: str, t: str) -> None:
+        try:
+            response = self.session.post(
+                f"{API_URL}?EIO=4&transport=polling&t={t}&sid={sid}",
+                data='40{"jwt":"anonymous-ask-user"}',
+                proxies=self.proxies
+            )
+            response.raise_for_status()
+            if response.text != "OK":
+                raise exceptions.AuthenticationError("Authentication failed")
+        except requests.exceptions.RequestException as e:
+            raise exceptions.ProviderConnectionError(f"Authentication failed: {e}")
+
+
+    def _websocket_interaction(
+        self,
+        sid: str,
+        t: str,
+        prompt: str,
+        model: str
+    ) -> Generator[str, None, None]:
+        ws = websocket.create_connection(
+            f"{WS_URL}?EIO=4&transport=websocket&sid={sid}",
+            header=[f"{k}: {v}" for k, v in self.headers.items()],
+            cookie="; ".join([f"{k}={v}" for k, v in self.session.cookies.items()]),
+            proxy=self.proxies.get("http") or self.proxies.get("https") if self.proxies else None,
+        )
+
+        try:
+            ws.send("2probe")
+            if ws.recv() != "3probe":
+                raise exceptions.ProviderConnectionError("WebSocket handshake failed")
+            ws.send("5")
+            ws.recv()
+            ws.recv()
+
+            message_data = {
+                "version": "2.5",
+                "source": "default",
+                "model": model,
+                "messages": [{"role": "user", "content": prompt}]
+            }
+            ws.send("42" + json.dumps(["perplexity_labs", message_data]))
+
+            last_message = 0
+            while True:
+                message = ws.recv()
+                if message == "2":
+                    if last_message == 0:
+                        raise exceptions.InvalidResponseError("No response received")
+                    ws.send("3")
+                    continue
+
+                try:
+                    data = json.loads(message[2:])[1]
+                    new_content = data["output"][last_message:]
+                    if new_content:
+                        yield new_content
+                    last_message = len(data["output"])
+                    if data.get("final", False):
+                        break
+                except Exception as e:
+                    raise exceptions.InvalidResponseError(f"Failed to parse message: {e}")
+
+        finally:
+            ws.close()
+
+    def ask(
+        self,
+        prompt: str,
+        stream: bool = False,
+        raw: bool = False,
+        optimizer: str = None,
+        conversationally: bool = False,
+    ) -> Union[str, Dict[str, Any]]:
+        """Ask a question and get a response."""
+        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:
+                raise exceptions.FailedToGenerateResponseError(
+                    f"Optimizer is not one of {self.__available_optimizers}"
+                )
+
+        t = format(random.getrandbits(32), "08x")
+        sid = self._get_session_id()
+        self._authenticate_session(sid, t)
+
+        def for_stream():
+            gen = self._websocket_interaction(sid, t, conversation_prompt, self.model)
+            full_response = ""
+            for chunk in gen:
+                full_response += chunk
+                response_dict = dict(text=chunk)
+                self.last_response.update(response_dict)
+                yield response_dict if not raw else chunk
+            self.conversation.update_chat_history(prompt, full_response)
+            
+        def for_non_stream():
+            full_response = "".join(self._websocket_interaction(sid, t, conversation_prompt, self.model))
+            self.last_response.update({"text": full_response})
+            self.conversation.update_chat_history(prompt, full_response)
+            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,
+    ) -> Union[str, Generator[str, None, None]]:
+        """Generate response
+        Args:
+            prompt (str): Prompt to be send.
+            stream (bool, optional): Flag for streaming response. Defaults to False.
+            optimizer (str, optional): Prompt optimizer name. Defaults to None.
+            conversationally (bool, optional): Chat conversationally when using optimizer. Defaults to False.
+        Returns:
+            Union[str, Generator[str, None, None]]: Response generated
+        """
+        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, Any]) -> str:
+        """Retrieves message only from response
+
+        Args:
+            response (dict): Response generated by `self.ask`
+
+        Returns:
+            str: Message extracted
+        """
+        assert isinstance(response, dict), "Response should be of dict data-type only"
+        return response["text"]
+
+if __name__ == "__main__":
+    from rich import print
+
+    ai = PerplexityLabs()
+    response = ai.chat("Tell me about Abhay Koul (HelpingAI)", stream=True)
+    for chunk in response:
+        print(chunk, end="", flush=True)