webscout 8.2.2__py3-none-any.whl → 2026.1.19__py3-none-any.whl

webscout/Provider/promptrefine.py

@@ -1,193 +0,0 @@
-import requests
-import uuid
-import json
-
-from webscout.AIutel import Optimizers
-from webscout.AIutel import Conversation
-from webscout.AIutel import AwesomePrompts
-from webscout.AIbase import Provider
-from webscout.litagent import LitAgent as UserAgent
-
-class PromptRefine(Provider):
-    """
-    A class to interact with the PromptRefine API.
-    """
-    AVAILABLE_MODELS = ["openai/gpt-4", "openai/gpt-4o", "openai/gpt-4-1106-preview"]
-    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.",
-        model: str = "openai/gpt-4o",  # Default model
-    ):
-        """
-        Initializes the PromptRefine 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.
-            system_prompt (str, optional): System prompt for PromptRefine. Defaults to "You are a helpful AI assistant.".
-            model (str, optional): Model to use for generation. Defaults to "openai/gpt-4o".
-        """
-        self.session = requests.Session()
-        self.is_conversation = is_conversation
-        self.max_tokens_to_sample = max_tokens
-        self.api_endpoint = 'https://www.promptrefine.com/api/completion'
-        self.stream_chunk_size = 64
-        self.timeout = timeout
-        self.last_response = {}
-        self.system_prompt = system_prompt
-        self.model = model
-        self.headers = {
-            'origin': 'https://www.promptrefine.com',
-            'referer': 'https://www.promptrefine.com/prompt/new',
-            'user-agent': UserAgent().random()
-        }
-
-        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
-        if self.model not in self.AVAILABLE_MODELS:
-            raise ValueError(f"Invalid model: {self.model}. Available models: {', '.join(self.AVAILABLE_MODELS)}")
-
-    def ask(
-        self,
-        prompt: str,
-        stream: bool = False,
-        raw: bool = False,
-        optimizer: str = None,
-        conversationally: bool = False,
-    ) -> dict:
-        """Chat with PromptRefine
-
-        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}"
-                )
-
-        payload = {
-            "messages": [
-                {"role": "system", "content": self.system_prompt},
-                {"role": "user", "content": conversation_prompt}
-            ],
-            "variables": {},
-            "parameters": {},
-            "model": self.model,
-            "userId": str(uuid.uuid4()),
-        }
-
-        def for_stream():
-            response = self.session.post(self.api_endpoint, headers=self.headers, json=payload, stream=True, timeout=self.timeout)
-            if not response.ok:
-                raise Exception(
-                    f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
-                )
-
-            full_response = ""
-            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=line)
-            self.last_response.update(dict(text=full_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`
-        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
-        """
-        return self.get_message(
-            self.ask(
-                prompt,
-                optimizer=optimizer,
-                conversationally=conversationally,
-            )
-        )
-
-    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 = PromptRefine(timeout=5000)
-    response = ai.chat("write a poem about AI", stream=True)
-    for chunk in response:
-        print(chunk, end="", flush=True)

webscout/Provider/scira_chat.py

@@ -1,277 +0,0 @@
-from os import system
-import requests
-import json
-import uuid
-import re
-from typing import Any, Dict, Optional, Union
-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.litagent import LitAgent
-
-class SciraAI(Provider):
-    """
-    A class to interact with the Scira AI chat API.
-    """
-
-    AVAILABLE_MODELS = {
-        "scira-default": "Grok3",
-        "scira-grok-3-mini": "Grok3-mini", # thinking model
-        "scira-vision" : "Grok2-Vision", # vision model
-        "scira-4.1-mini": "GPT4.1-mini",
-        "scira-qwq": "QWQ-32B",
-        "scira-o4-mini": "o4-mini",
-        "scira-google": "gemini 2.5 flash"
-
-
-    }
-
-    def __init__(
-        self,
-        is_conversation: bool = True,
-        max_tokens: int = 2049,
-        timeout: int = 30,
-        intro: str = None,
-        filepath: str = None,
-        update_file: bool = True,
-        proxies: dict = {},
-        history_offset: int = 10250,
-        act: str = None,
-        model: str = "scira-default",
-        chat_id: str = None,
-        user_id: str = None,
-        browser: str = "chrome",
-        system_prompt: str = "You are a helpful assistant.",
-    ):
-        """Initializes the Scira AI API client.
-
-        Args:
-            is_conversation (bool): Whether to maintain conversation history.
-            max_tokens (int): Maximum number of tokens to generate.
-            timeout (int): Request timeout in seconds.
-            intro (str): Introduction text for the conversation.
-            filepath (str): Path to save conversation history.
-            update_file (bool): Whether to update the conversation history file.
-            proxies (dict): Proxy configuration for requests.
-            history_offset (int): Maximum history length in characters.
-            act (str): Persona for the AI to adopt.
-            model (str): Model to use, must be one of AVAILABLE_MODELS.
-            chat_id (str): Unique identifier for the chat session.
-            user_id (str): Unique identifier for the user.
-            browser (str): Browser to emulate in requests.
-            system_prompt (str): System prompt for the AI.
-
-        """
-        if model not in self.AVAILABLE_MODELS:
-            raise ValueError(f"Invalid model: {model}. Choose from: {self.AVAILABLE_MODELS}")
-
-        self.url = "https://scira.ai/api/search"
-
-        # Initialize LitAgent for user agent generation
-        self.agent = LitAgent()
-        # Use fingerprinting to create a consistent browser identity
-        self.fingerprint = self.agent.generate_fingerprint(browser)
-        self.system_prompt = system_prompt
-        
-        # Use the fingerprint for headers
-        self.headers = {
-            "Accept": self.fingerprint["accept"],
-            "Accept-Encoding": "gzip, deflate, br, zstd",
-            "Accept-Language": self.fingerprint["accept_language"],
-            "Content-Type": "application/json",
-            "Origin": "https://scira.ai",
-            "Referer": "https://scira.ai/",
-            "Sec-CH-UA": self.fingerprint["sec_ch_ua"] or '"Not)A;Brand";v="99", "Microsoft Edge";v="127", "Chromium";v="127"',
-            "Sec-CH-UA-Mobile": "?0",
-            "Sec-CH-UA-Platform": f'"{self.fingerprint["platform"]}"',
-            "User-Agent": self.fingerprint["user_agent"],
-            "Sec-Fetch-Dest": "empty",
-            "Sec-Fetch-Mode": "cors",
-            "Sec-Fetch-Site": "same-origin"
-        }
-
-        self.session = requests.Session()
-        self.session.headers.update(self.headers)
-        self.session.proxies.update(proxies)
-
-        self.is_conversation = is_conversation
-        self.max_tokens_to_sample = max_tokens
-        self.timeout = timeout
-        self.last_response = {}
-        self.model = model
-        self.chat_id = chat_id or str(uuid.uuid4())
-        self.user_id = user_id or f"user_{str(uuid.uuid4())[:8].upper()}"
-
-        # Always use chat mode (no web search)
-        self.search_mode = "chat"
-
-        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 refresh_identity(self, browser: str = None):
-        """
-        Refreshes the browser identity fingerprint.
-
-        Args:
-            browser: Specific browser to use for the new fingerprint
-        """
-        browser = browser or self.fingerprint.get("browser_type", "chrome")
-        self.fingerprint = self.agent.generate_fingerprint(browser)
-
-        # Update headers with new fingerprint
-        self.headers.update({
-            "Accept": self.fingerprint["accept"],
-            "Accept-Language": self.fingerprint["accept_language"],
-            "Sec-CH-UA": self.fingerprint["sec_ch_ua"] or self.headers["Sec-CH-UA"],
-            "Sec-CH-UA-Platform": f'"{self.fingerprint["platform"]}"',
-            "User-Agent": self.fingerprint["user_agent"],
-        })
-
-        # Update session headers
-        for header, value in self.headers.items():
-            self.session.headers[header] = value
-
-        return self.fingerprint
-
-    def ask(
-        self,
-        prompt: str,
-        optimizer: str = None,
-        conversationally: bool = False,
-    ) -> Dict[str, Any]:
-        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}")
-
-        messages = [
-            {"role": "system", "content": self.system_prompt},
-            {"role": "user", "content": conversation_prompt, "parts": [{"type": "text", "text": conversation_prompt}]}
-        ]
-
-        # Prepare the request payload
-        payload = {
-            "id": self.chat_id,
-            "messages": messages,
-            "model": self.model,
-            "group": self.search_mode,
-            "user_id": self.user_id,
-            "timezone": "Asia/Calcutta"
-        }
-
-        try:
-            response = self.session.post(self.url, json=payload, timeout=self.timeout)
-            if response.status_code != 200:
-                # Try to get response content for better error messages
-                try:
-                    error_content = response.text
-                except:
-                    error_content = "<could not read response content>"
-
-                if response.status_code in [403, 429]:
-                    print(f"Received status code {response.status_code}, refreshing identity...")
-                    self.refresh_identity()
-                    response = self.session.post(self.url, json=payload, timeout=self.timeout)
-                    if not response.ok:
-                        raise exceptions.FailedToGenerateResponseError(
-                            f"Failed to generate response after identity refresh - ({response.status_code}, {response.reason}) - {error_content}"
-                        )
-                    print("Identity refreshed successfully.")
-                else:
-                    raise exceptions.FailedToGenerateResponseError(
-                        f"Request failed with status code {response.status_code}. Response: {error_content}"
-                    )
-
-            full_response = ""
-            debug_lines = []
-
-            # Collect the first few lines for debugging
-            for i, line in enumerate(response.iter_lines()):
-                if line:
-                    try:
-                        line_str = line.decode('utf-8')
-                        debug_lines.append(line_str)
-
-                        # Format 2: 0:"content" (quoted format)
-                        match = re.search(r'0:"(.*?)"', line_str)
-                        if match:
-                            content = match.group(1)
-                            full_response += content
-                            continue
-
-
-                    except: pass
-            self.last_response = {"text": full_response}
-            self.conversation.update_chat_history(prompt, full_response)
-            return {"text": full_response}
-        except Exception as e:
-            raise exceptions.FailedToGenerateResponseError(f"Request failed: {e}")
-
-    def chat(
-        self,
-        prompt: str,
-        optimizer: str = None,
-        conversationally: bool = False,
-    ) -> str:
-        return self.get_message(
-            self.ask(
-                prompt, optimizer=optimizer, conversationally=conversationally
-            )
-        )
-
-    def get_message(self, response: dict) -> str:
-        assert isinstance(response, dict), "Response should be of dict data-type only"
-        return response["text"].replace('\\n', '\n').replace('\\n\\n', '\n\n')
-
-if __name__ == "__main__":
-    print("-" * 100)
-    print(f"{'Model':<50} {'Status':<10} {'Response'}")
-    print("-" * 100)
-
-    test_prompt = "Say 'Hello' in one word"
-
-    # Test each model
-    for model in SciraAI.AVAILABLE_MODELS:
-        print(f"\rTesting {model}...", end="")
-
-        try:
-            test_ai = SciraAI(model=model, timeout=120)  # Increased timeout
-            response = test_ai.chat(test_prompt)
-
-            if response and len(response.strip()) > 0:
-                status = "✓"
-                # Clean and truncate response
-                clean_text = response.strip().encode('utf-8', errors='ignore').decode('utf-8')
-                display_text = clean_text[:50] + "..." if len(clean_text) > 50 else clean_text
-            else:
-                status = "✗"
-                display_text = "Empty or invalid response"
-
-            print(f"\r{model:<50} {status:<10} {display_text}")
-        except Exception as e:
-            error_msg = str(e)
-            # Truncate very long error messages
-            if len(error_msg) > 100:
-                error_msg = error_msg[:97] + "..."
-            print(f"\r{model:<50} {'✗':<10} Error: {error_msg}")

webscout/Provider/scnet.py

@@ -1,187 +0,0 @@
-import requests
-import json
-import secrets
-from typing import Any, Dict, Optional, Generator, Union
-
-from webscout.AIutel import Optimizers, Conversation, AwesomePrompts
-from webscout.AIbase import Provider
-from webscout import exceptions
-
-class SCNet(Provider):
-    """
-    Provider for SCNet chatbot API.
-    """
-    AVAILABLE_MODELS = [
-        {"modelId": 2, "name": "Deepseek-r1-7B"},
-        {"modelId": 3, "name": "Deepseek-r1-32B"},
-        {"modelId": 5, "name": "Deepseek-r1-70B"},
-        {"modelId": 7, "name": "QWQ-32B"},
-        {"modelId": 8, "name": "minimax-text-01-456B"},
-        # Add more models here as needed
-    ]
-    MODEL_NAME_TO_ID = {m["name"]: m["modelId"] for m in AVAILABLE_MODELS}
-    MODEL_ID_TO_NAME = {m["modelId"]: m["name"] for m in AVAILABLE_MODELS}
-
-    def __init__(
-        self,
-        model: str = "QWQ-32B",
-        is_conversation: bool = True,
-        max_tokens: int = 2048,
-        timeout: int = 30,
-        intro: Optional[str] = None,
-        filepath: Optional[str] = None,
-        update_file: bool = True,
-        proxies: Optional[dict] = None,
-        history_offset: int = 0,
-        act: Optional[str] = None,
-        system_prompt: str = (
-            "You are a helpful, advanced LLM assistant. "
-            "You must always answer in English, regardless of the user's language. "
-            "If the user asks in another language, politely respond in English only. "
-            "Be clear, concise, and helpful."
-        ),
-    ):
-        if model not in self.MODEL_NAME_TO_ID:
-            raise ValueError(f"Invalid model: {model}. Choose from: {list(self.MODEL_NAME_TO_ID.keys())}")
-        self.model = model
-        self.modelId = self.MODEL_NAME_TO_ID[model]
-        self.system_prompt = system_prompt
-        self.session = requests.Session()
-        self.is_conversation = is_conversation
-        self.max_tokens_to_sample = max_tokens
-        self.timeout = timeout
-        self.last_response: Dict[str, Any] = {}
-        self.proxies = proxies or {}
-        self.cookies = {
-            "Token": secrets.token_hex(16),
-        }
-        self.headers = {
-            "accept": "text/event-stream",
-            "content-type": "application/json",
-            "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36 Edg/135.0.0.0",
-            "referer": "https://www.scnet.cn/ui/chatbot/temp_1744712663464",
-            "origin": "https://www.scnet.cn",
-        }
-        self.url = "https://www.scnet.cn/acx/chatbot/v1/chat/completion"
-        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, max_tokens, filepath, update_file)
-        self.conversation.history_offset = history_offset
-
-    def ask(
-        self,
-        prompt: str,
-        stream: bool = False,
-        raw: bool = False,
-        optimizer: Optional[str] = None,
-        conversationally: bool = False,
-    ) -> Union[Dict[str, Any], Generator]:
-        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 {list(self.__available_optimizers)}")
-
-        payload = {
-            "conversationId": "",
-            "content": f"SYSTEM: {self.system_prompt} USER: {conversation_prompt}",
-            "thinking": 0,
-            "online": 0,
-            "modelId": self.modelId,
-            "textFile": [],
-            "imageFile": [],
-            "clusterId": ""
-        }
-
-        def for_stream():
-            try:
-                with self.session.post(
-                    self.url,
-                    headers=self.headers,
-                    cookies=self.cookies,
-                    json=payload,
-                    stream=True,
-                    timeout=self.timeout,
-                    proxies=self.proxies
-                ) as resp:
-                    streaming_text = ""
-                    for line in resp.iter_lines(decode_unicode=True):
-                        if line and line.startswith("data:"):
-                            data = line[5:].strip()
-                            if data and data != "[done]":
-                                try:
-                                    obj = json.loads(data)
-                                    content = obj.get("content", "")
-                                    streaming_text += content
-                                    yield {"text": content} if raw else {"text": content}
-                                except Exception:
-                                    continue
-                            elif data == "[done]":
-                                break
-                    self.last_response = {"text": streaming_text}
-                    self.conversation.update_chat_history(prompt, streaming_text)
-            except Exception as e:
-                raise exceptions.FailedToGenerateResponseError(f"Request failed: {e}")
-
-        def for_non_stream():
-            text = ""
-            for chunk in for_stream():
-                text += chunk["text"]
-            return {"text": text}
-
-        return for_stream() if stream else for_non_stream()
-
-    def chat(
-        self,
-        prompt: str,
-        stream: bool = False,
-        optimizer: Optional[str] = None,
-        conversationally: bool = False,
-    ) -> Union[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():
-            return self.get_message(
-                self.ask(
-                    prompt, stream=False, optimizer=optimizer, conversationally=conversationally
-                )
-            )
-        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"]
-
-if __name__ == "__main__":
-    print("-" * 80)
-    print(f"{'ModelId':<10} {'Model':<30} {'Status':<10} {'Response'}")
-    print("-" * 80)
-    for model in SCNet.AVAILABLE_MODELS:
-        try:
-            test_ai = SCNet(model=model["name"], timeout=60)
-            response = test_ai.chat("Say 'Hello' in one word", stream=True)
-            response_text = ""
-            for chunk in response:
-                response_text += chunk
-            if response_text and len(response_text.strip()) > 0:
-                status = "✓"
-                display_text = response_text.strip()[:50] + "..." if len(response_text.strip()) > 50 else response_text.strip()
-            else:
-                status = "✗"
-                display_text = "Empty or invalid response"
-            print(f"{model['modelId']:<10} {model['name']:<30} {status:<10} {display_text}")
-        except Exception as e:
-            print(f"{model['modelId']:<10} {model['name']:<30} {'✗':<10} {str(e)}")