webscout 5.8__py3-none-any.whl → 6.0__py3-none-any.whl

webscout/Provider/elmo.py

@@ -1,7 +1,4 @@
 import requests
-import json
-import textwrap
-
 from webscout.AIutel import Optimizers
 from webscout.AIutel import Conversation
 from webscout.AIutel import AwesomePrompts
@@ -169,7 +166,7 @@ class Elmo(Provider):
                         )
                         full_response += formatted_output
                         self.last_response.update(dict(text=full_response))
-                        yield formatted_output if raw else dict(text=full_response)
+                        yield formatted_output if raw else dict(text=formatted_output)
             self.conversation.update_chat_history(
                 prompt, self.get_message(self.last_response)
             )
@@ -232,6 +229,6 @@ class Elmo(Provider):
 if __name__ == "__main__":
     from rich import print
     ai = Elmo()
-    response = ai.chat("hi")
+    response = ai.chat("write a poem about AI", stream=True)
     for chunk in response:
         print(chunk, end="", flush=True)

webscout/Provider/julius.py

@@ -66,22 +66,13 @@ class Julius(Provider):
         self.last_response = {}
         self.model = model
         self.headers = {
-            "accept": "*/*",
-            "accept-encoding": "gzip, deflate, br, zstd",
-            "accept-language": "en-US,en;q=0.9,en-IN;q=0.8",
             "authorization": "Bearer",
-            "content-length": "206",
             "content-type": "application/json",
             "conversation-id": str(uuid.uuid4()),
-            "dnt": "1",
             "interactive-charts": "true",
             "is-demo": "temp_14aabbb1-95bc-4203-a678-596258d6fdf3",
             "is-native": "false",
             "orient-split": "true",
-            "origin": "https://julius.ai",
-            "platform": "undefined",
-            "priority": "u=1, i",
-            "referer": "https://julius.ai/",
             "request-id": str(uuid.uuid4()),
             "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36 Edg/127.0.0.0",
             "visitor-id": str(uuid.uuid4())
@@ -165,7 +156,7 @@ class Julius(Provider):
                         json_line = json.loads(line)
                         content = json_line['content']
                         streaming_response += content
-                        yield content if raw else dict(text=streaming_response)
+                        yield content if raw else dict(text=content)
                     except:
                         continue
             self.last_response.update(dict(text=streaming_response))
@@ -174,30 +165,13 @@ class Julius(Provider):
             )
 
         def for_non_stream():
-            response = self.session.post(
-                self.chat_endpoint, json=payload, headers=self.headers, timeout=self.timeout
-            )
 
-            if not response.ok:
-                raise exceptions.FailedToGenerateResponseError(
-                    f"Failed to generate response - ({response.status_code}, {response.reason})"
-                )
-            full_content = ""
-            for line in response.text.splitlines():
-                try:
-                    data = json.loads(line)
-                    if "content" in data:
-                        full_content += data['content']
-                except json.JSONDecodeError:
-                    pass
-            self.last_response.update(dict(text=full_content))
-            self.conversation.update_chat_history(
-                prompt, self.get_message(self.last_response)
-            )
+            for _ in for_stream():
+                pass
             return self.last_response
 
-        return for_stream() if stream else for_non_stream()
 
+        return for_stream() if stream else for_non_stream()
     def chat(
         self,
         prompt: str,
@@ -234,19 +208,11 @@ class Julius(Provider):
         return for_stream() if stream else for_non_stream()
 
     def get_message(self, response: dict) -> 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 = Julius()
-    response = ai.chat("hi")
+    ai = Julius(timeout=5000)
+    response = ai.chat("write a poem about AI", stream=True)
     for chunk in response:
         print(chunk, end="", flush=True)

webscout/Provider/learnfastai.py

@@ -0,0 +1,253 @@
+import os
+import json
+from typing import Optional
+import uuid
+import requests
+import cloudscraper
+
+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 LearnFast(Provider):
+    """
+    A class to interact with the LearnFast.ai API.
+    """
+
+    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,
+        system_prompt: str = "You are a helpful AI assistant.",
+    ):
+        """
+        Initializes the LearnFast.ai API with given parameters.
+        """
+        self.session = cloudscraper.create_scraper()
+        self.is_conversation = is_conversation
+        self.max_tokens_to_sample = max_tokens
+        self.api_endpoint = 'https://autosite.erweima.ai/api/v1/chat'
+        self.stream_chunk_size = 64
+        self.timeout = timeout
+        self.last_response = {}
+        self.system_prompt = system_prompt
+        self.headers = {
+            "authority": "autosite.erweima.ai",
+            "accept": "*/*",
+            "accept-encoding": "gzip, deflate, br, zstd",
+            "accept-language": "en-US,en;q=0.9,en-IN;q=0.8",
+            "authorization": "",  # Always empty
+            "content-type": "application/json",
+            "dnt": "1",
+            "origin": "https://learnfast.ai",
+            "priority": "u=1, i",
+            "referer": "https://learnfast.ai/",
+            "sec-ch-ua": '"Microsoft Edge";v="129", "Not=A?Brand";v="8", "Chromium";v="129"',
+            "sec-ch-ua-mobile": "?0",
+            "sec-ch-ua-platform": '"Windows"',
+            "sec-fetch-dest": "empty",
+            "sec-fetch-mode": "cors",
+            "sec-fetch-site": "cross-site",
+            "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.__available_optimizers = (
+            method
+            for method in dir(Optimizers)
+            if callable(getattr(Optimizers, method)) and not method.startswith("__")
+        )
+        self.session.headers.update(self.headers)
+        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 generate_unique_id(self) -> str:
+        """Generate a 32-character hexadecimal unique ID."""
+        return uuid.uuid4().hex
+
+    def generate_session_id(self) -> str:
+        """Generate a 32-character hexadecimal session ID."""
+        return uuid.uuid4().hex
+
+    def upload_image_to_0x0(self, image_path: str) -> str:
+        """
+        Uploads an image to 0x0.st and returns the public URL.
+        """
+        if not os.path.isfile(image_path):
+            raise FileNotFoundError(f"The file '{image_path}' does not exist.")
+
+        with open(image_path, "rb") as img_file:
+            files = {"file": img_file}
+            try:
+                response = requests.post("https://0x0.st", files=files)
+                response.raise_for_status()
+                image_url = response.text.strip()
+                if not image_url.startswith("http"):
+                    raise ValueError("Received an invalid URL from 0x0.st.")
+                return image_url
+            except requests.exceptions.RequestException as e:
+                raise Exception(f"Failed to upload image to 0x0.st: {e}") from e
+
+    def create_payload(
+        self,
+        session_id: str,
+        conversation_prompt: str,
+        image_url: Optional[str] = None
+    ) -> dict:
+        """
+        Creates the JSON payload for the request.
+        """
+        payload = {
+            "prompt": conversation_prompt,
+            "sessionId": session_id,
+        }
+        if image_url:
+            payload["attachments"] = [
+                {
+                    "fileType": "image/jpeg",
+                    "file": {},
+                    "fileContent": image_url
+                }
+            ]
+        return payload
+
+    def ask(
+        self,
+        prompt: str,
+        stream: bool = False,
+        raw: bool = False,
+        optimizer: str = None,
+        conversationally: bool = False,
+        image_path: Optional[str] = None,
+    ) -> dict:
+        """Chat with LearnFast
+
+        Args:
+            prompt (str): Prompt to be send.
+            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.
+            image_path (Optional[str], optional): Path to the image to be uploaded.
+                                                 Defaults to None.
+
+        Returns:
+           dict : {}
+        """
+        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 Exception(
+                    f"Optimizer is not one of {self.__available_optimizers}"
+                )
+
+        # Generate unique ID and session ID
+        unique_id = self.generate_unique_id()
+        session_id = self.generate_session_id()
+
+        # Update headers with the unique ID
+        self.headers["uniqueid"] = unique_id
+
+        # Upload image and get URL if image_path is provided
+        image_url = None
+        if image_path:
+            try:
+                image_url = self.upload_image_to_0x0(image_path)
+            except Exception as e:
+                raise exceptions.FailedToGenerateResponseError(f"Error uploading image: {e}") from e
+
+        # Create the payload
+        payload = self.create_payload(session_id, conversation_prompt, image_url)
+
+        # Convert the payload to a JSON string
+        data = json.dumps(payload)
+
+        try:
+            # Send the POST request with streaming enabled
+            response = self.session.post(self.api_endpoint, headers=self.headers, data=data, stream=True, timeout=self.timeout)
+            response.raise_for_status()  # Check for HTTP errors
+
+            # Process the streamed response
+            full_response = ""
+            for line in response.iter_lines(decode_unicode=True):
+                if line:
+                    if line.strip() == "[DONE]":
+                        break
+                    try:
+                        json_response = json.loads(line)
+                        message = json_response.get('data', {}).get('message', '')
+                        if message:
+                            full_response += message
+                            # print(message, end='', flush=True)
+                    except json.JSONDecodeError:
+                        print(f"\nFailed to parse JSON: {line}")
+            self.last_response.update({"text": full_response})
+            self.conversation.update_chat_history(prompt, full_response)
+
+            return self.last_response
+        except requests.exceptions.RequestException as e:
+            raise exceptions.FailedToGenerateResponseError(f"An error occurred: {e}")
+
+    def chat(
+        self,
+        prompt: str,
+        stream: bool = False,
+        optimizer: str = None,
+        conversationally: bool = False,
+        image_path: Optional[str] = None,
+    ) -> str:
+        """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.
+            image_path (Optional[str], optional): Path to the image to be uploaded.
+                                                 Defaults to None.
+        Returns:
+            str: Response generated
+        """
+        response = self.ask(prompt, stream, optimizer=optimizer, conversationally=conversationally, image_path=image_path)
+        return self.get_message(response)
+
+    def get_message(self, response: dict) -> 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 = LearnFast()
+    response = ai.chat(input(">>> "), image_path="photo_2024-07-06_22-19-42.jpg")
+    for chunk in response:
+        print(chunk, end="", flush=True)

webscout/Provider/llamatutor.py

@@ -147,7 +147,7 @@ class LlamaTutor(Provider):
                             json_data = json.loads(decoded_line[6:])
                             if "text" in json_data:
                                 full_response += json_data["text"]
-                                yield json_data["text"] if raw else dict(text=full_response)
+                                yield json_data["text"] if raw else dict(text=json_data["text"])
 
                 self.last_response.update(dict(text=full_response))
                 self.conversation.update_chat_history(
@@ -217,6 +217,6 @@ if __name__ == "__main__":
     from rich import print
 
     ai = LlamaTutor()
-    response = ai.chat(input(">>> "))
+    response = ai.chat("write a poem about AI", stream=True)
     for chunk in response:
         print(chunk, end="", flush=True)

webscout/Provider/prefind.py

@@ -0,0 +1,232 @@
+import requests
+import json
+import uuid
+import os
+from typing import Any, Dict, Optional, Generator
+
+from webscout.AIutel import Optimizers
+from webscout.AIutel import Conversation
+from webscout.AIutel import AwesomePrompts, sanitize_stream
+from webscout.AIbase import  Provider, AsyncProvider
+from webscout import exceptions
+
+class PrefindAI(Provider):
+    """
+    A class to interact with the Prefind AI API.
+    """
+
+    AVAILABLE_MODELS = ["llama", "claude"]
+
+    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 = "claude",
+    ):
+        """
+        Initializes the Prefind AI API with given parameters.
+
+        Args:
+            is_conversation (bool, optional): Flag for chatting conversationally. Defaults to True.
+            max_tokens (int, optional): Maximum number of tokens to be generated upon completion. Defaults to 600.
+            timeout (int, optional): Http request timeout. Defaults to 30.
+            intro (str, optional): Conversation introductory prompt. Defaults to None.
+            filepath (str, optional): Path to file containing conversation history. Defaults to None.
+            update_file (bool, optional): Add new prompts and responses to the file. Defaults to True.
+            proxies (dict, optional): Http request proxies. Defaults to {}.
+            history_offset (int, optional): Limit conversation history to this number of last texts. Defaults to 10250.
+            act (str|int, optional): Awesome prompt key or index. (Used as intro). Defaults to None.
+            model (str, optional): The AI model to use for text generation. Defaults to "claude". 
+                                    Options: "llama", "claude".
+        """
+        self.session = requests.Session()
+        self.is_conversation = is_conversation
+        self.max_tokens_to_sample = max_tokens
+        self.api_endpoint = "https://api.prefind.ai/api/search/v1"
+        self.stream_chunk_size = 64
+        self.timeout = timeout
+        self.last_response = {}
+        self.model = model
+        self.device_token = self.get_device_token()
+
+        self.__available_optimizers = (
+            method
+            for method in dir(Optimizers)
+            if callable(getattr(Optimizers, method)) and not method.startswith("__")
+        )
+        self.session.headers.update(
+            {
+                "Content-Type": "application/json",
+                "Accept": "text/event-stream",
+            }
+        )
+        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 get_device_token(self) -> str:
+        """
+        Retrieves a device token from the Prefind AI API.
+        """
+        device_token_url = "https://api.prefind.ai/api/auth/device-token/create"
+        headers = {"Content-Type": "application/json; charset=utf-8"}
+        data = {}
+        response = requests.post(
+            device_token_url, headers=headers, data=json.dumps(data)
+        )
+
+        if response.status_code == 200:
+            device_token_data = response.json()
+            return device_token_data["sessionToken"]
+        else:
+            raise exceptions.FailedToGenerateResponseError(
+                f"Failed to get device token - ({response.status_code}, {response.reason}) - {response.text}"
+            )
+
+    def ask(
+        self,
+        prompt: str,
+        stream: bool = False,
+        raw: bool = False,
+        optimizer: str = None,
+        conversationally: bool = False,
+    ) -> Dict[str, Any]:
+        """Chat with AI
+
+        Args:
+            prompt (str): Prompt to be send.
+            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 : {}
+        ```json
+        {
+           "text" : "How may I assist you today?"
+        }
+        ```
+        """
+        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 Exception(
+                    f"Optimizer is not one of {self.__available_optimizers}"
+                )
+
+        search_data = {"query": conversation_prompt, "deviceToken": self.device_token}
+        
+        def for_stream():
+            response = self.session.post(
+                self.api_endpoint, json=search_data, stream=True, timeout=self.timeout
+            )
+            if not response.ok:
+                raise exceptions.FailedToGenerateResponseError(
+                    f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
+                )
+
+            streaming_text = ""
+            for line in response.iter_lines(decode_unicode=True): #This is already decoding
+                if line:
+                    # line = line.decode('utf-8').strip() # This line is unnecessary and causing the error
+                    if line.startswith("event: "):
+                        event = line[7:]
+                    elif line.startswith("data: "):
+                        data_str = line[6:]
+                        if event == "received":
+                            data = json.loads(data_str)
+                            if data['type'] == 'chunk':
+                                model = data['model']
+                                if (self.model == "llama" and model == 'OPENROUTER_LLAMA_3') or \
+                                   (self.model == "claude" and model == 'OPENROUTER_CLAUDE'):
+                                    content = data['chunk']['content']
+                                    if content:
+                                        streaming_text += content #+ ("\n" if stream else "")
+                                        resp = dict(text=content)
+                                        self.last_response.update(resp)
+                                        yield resp if raw else resp
+            self.conversation.update_chat_history(
+                prompt, self.get_message(self.last_response)
+            )
+
+        def for_non_stream():
+            # let's make use of 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`
+        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:
+        """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 = PrefindAI(model="claude")
+    response = ai.chat("write a poem about AI", stream=True)
+    for chunk in response:
+        print(chunk, end="", flush=True)

webscout/Provider/promptrefine.py

@@ -134,7 +134,7 @@ class PromptRefine(Provider):
             for line in response.iter_lines(decode_unicode=True):
                 if line:
                     full_response += line  # No need to decode here
-                    yield full_response if raw else dict(text=full_response)
+                    yield full_response if raw else dict(text=line)
             self.last_response.update(dict(text=full_response))
             self.conversation.update_chat_history(
                 prompt, self.get_message(self.last_response)
@@ -185,7 +185,7 @@ class PromptRefine(Provider):
 
 if __name__ == '__main__':
     from rich import print
-    ai = PromptRefine()
-    response = ai.chat(input(">>> "))
+    ai = PromptRefine(timeout=5000)
+    response = ai.chat("write a poem about AI", stream=True)
     for chunk in response:
         print(chunk, end="", flush=True)

webscout/Provider/turboseek.py

@@ -138,7 +138,7 @@ class TurboSeek(Provider):
                 raise exceptions.FailedToGenerateResponseError(
                     f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
                 )
-
+            print(response.text)
             streaming_text = ""
             for value in response.iter_lines(
                 decode_unicode=True,