webscout 8.0__py3-none-any.whl → 8.2__py3-none-any.whl

webscout/Provider/OPENAI/textpollinations.py

@@ -0,0 +1,285 @@
+import time
+import uuid
+import requests
+import json
+from typing import List, Dict, Optional, Union, Generator, Any
+
+# Import base classes and utility structures
+from .base import OpenAICompatibleProvider, BaseChat, BaseCompletions
+from .utils import (
+    ChatCompletionChunk, ChatCompletion, Choice, ChoiceDelta,
+    ChatCompletionMessage, CompletionUsage
+)
+
+# Import LitAgent for browser fingerprinting
+from webscout.litagent import LitAgent
+
+# ANSI escape codes for formatting
+BOLD = "\033[1m"
+RED = "\033[91m"
+RESET = "\033[0m"
+
+class Completions(BaseCompletions):
+    def __init__(self, client: 'TextPollinations'):
+        self._client = client
+
+    def create(
+        self,
+        *,
+        model: str,
+        messages: List[Dict[str, str]],
+        max_tokens: Optional[int] = None,
+        stream: bool = False,
+        temperature: Optional[float] = None,
+        top_p: Optional[float] = None,
+        **kwargs: Any
+    ) -> Union[ChatCompletion, Generator[ChatCompletionChunk, None, None]]:
+        """
+        Creates a model response for the given chat conversation.
+        Mimics openai.chat.completions.create
+        """
+        payload = {
+            "model": model,
+            "messages": messages,
+            "stream": stream,
+        }
+        if max_tokens is not None:
+            payload["max_tokens"] = max_tokens
+        if temperature is not None:
+            payload["temperature"] = temperature
+        if top_p is not None:
+            payload["top_p"] = top_p
+
+        payload.update(kwargs)
+
+        request_id = str(uuid.uuid4())
+        created_time = int(time.time())
+
+        if stream:
+            return self._create_streaming(request_id, created_time, model, payload)
+        else:
+            return self._create_non_streaming(request_id, created_time, model, payload)
+
+    def _create_streaming(
+        self,
+        request_id: str,
+        created_time: int,
+        model: str,
+        payload: Dict[str, Any]
+    ) -> Generator[ChatCompletionChunk, None, None]:
+        """Implementation for streaming chat completions."""
+        try:
+
+            # Make the streaming request
+            response = self._client.session.post(
+                self._client.api_endpoint,
+                headers=self._client.headers,
+                json=payload,
+                stream=True,
+                timeout=self._client.timeout
+            )
+
+            if not response.ok:
+                raise IOError(f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}")
+
+            # Process the streaming response
+            full_response = ""
+
+            for line in response.iter_lines():
+                if line:
+                    line = line.decode('utf-8').strip()
+                    if line == "data: [DONE]":
+                        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]
+                                if 'delta' in choice and 'content' in choice['delta']:
+                                    content = choice['delta']['content']
+                                    full_response += content
+
+                                    # Create and yield a chunk
+                                    delta = ChoiceDelta(content=content)
+                                    choice = Choice(index=0, delta=delta, finish_reason=None)
+                                    chunk = ChatCompletionChunk(
+                                        id=request_id,
+                                        choices=[choice],
+                                        created=created_time,
+                                        model=model
+                                    )
+
+                                    yield chunk
+                        except json.JSONDecodeError:
+                            continue
+
+            # Final chunk with finish_reason
+            delta = ChoiceDelta(content=None)
+            choice = Choice(index=0, delta=delta, finish_reason="stop")
+            chunk = ChatCompletionChunk(
+                id=request_id,
+                choices=[choice],
+                created=created_time,
+                model=model
+            )
+
+            yield chunk
+
+        except Exception as e:
+            print(f"{RED}Error during TextPollinations streaming request: {e}{RESET}")
+            raise IOError(f"TextPollinations streaming request failed: {e}") from e
+
+    def _create_non_streaming(
+        self,
+        request_id: str,
+        created_time: int,
+        model: str,
+        payload: Dict[str, Any]
+    ) -> ChatCompletion:
+        """Implementation for non-streaming chat completions."""
+        try:
+
+            # Make the non-streaming request
+            response = self._client.session.post(
+                self._client.api_endpoint,
+                headers=self._client.headers,
+                json=payload,
+                timeout=self._client.timeout
+            )
+
+            if not response.ok:
+                raise IOError(f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}")
+
+            # Parse the response
+            response_json = response.json()
+
+            # Extract the content
+            if 'choices' in response_json and len(response_json['choices']) > 0:
+                if 'message' in response_json['choices'][0]:
+                    full_content = response_json['choices'][0]['message']['content']
+                else:
+                    full_content = ""
+            else:
+                full_content = ""
+
+            # Create the completion message
+            message = ChatCompletionMessage(
+                role="assistant",
+                content=full_content
+            )
+
+            # Create the choice
+            choice = Choice(
+                index=0,
+                message=message,
+                finish_reason="stop"
+            )
+
+            # Estimate token usage (very rough estimate)
+            prompt_tokens = sum(len(msg.get("content", "")) // 4 for msg in payload.get("messages", []))
+            completion_tokens = len(full_content) // 4
+            usage = CompletionUsage(
+                prompt_tokens=prompt_tokens,
+                completion_tokens=completion_tokens,
+                total_tokens=prompt_tokens + completion_tokens
+            )
+
+            # Create the completion object
+            completion = ChatCompletion(
+                id=request_id,
+                choices=[choice],
+                created=created_time,
+                model=model,
+                usage=usage,
+            )
+
+            return completion
+
+        except Exception as e:
+            print(f"{RED}Error during TextPollinations non-stream request: {e}{RESET}")
+            raise IOError(f"TextPollinations request failed: {e}") from e
+
+class Chat(BaseChat):
+    def __init__(self, client: 'TextPollinations'):
+        self.completions = Completions(client)
+
+class TextPollinations(OpenAICompatibleProvider):
+    """
+    OpenAI-compatible client for TextPollinations API.
+
+    Usage:
+        client = TextPollinations()
+        response = client.chat.completions.create(
+            model="openai-large",
+            messages=[{"role": "user", "content": "Hello!"}]
+        )
+        print(response.choices[0].message.content)
+    """
+
+    AVAILABLE_MODELS = [
+        "openai",
+        "openai-large",
+        "openai-reasoning",
+        "qwen-coder",
+        "llama",
+        "llamascout",
+        "mistral",
+        "unity",
+        "midijourney",
+        "rtist",
+        "searchgpt",
+        "evil",
+        "deepseek-reasoning",
+        "deepseek-reasoning-large",
+        "llamalight",
+        "phi",
+        "llama-vision",
+        "pixtral",
+        "gemini",
+        "hormoz",
+        "hypnosis-tracy",
+        "mistral-roblox",
+        "roblox-rp",
+        "deepseek",
+        "sur",
+        "llama-scaleway",
+        "openai-audio",
+    ]
+
+    def __init__(
+        self,
+        timeout: int = 30,
+        proxies: dict = {}
+    ):
+        """
+        Initialize the TextPollinations client.
+
+        Args:
+            timeout: Request timeout in seconds
+            proxies: Optional proxy configuration
+        """
+        self.timeout = timeout
+        self.api_endpoint = "https://text.pollinations.ai/openai"
+        self.proxies = proxies
+
+        # Initialize session
+        self.session = requests.Session()
+        if proxies:
+            self.session.proxies.update(proxies)
+
+        # Initialize LitAgent for user agent generation
+        agent = LitAgent()
+        self.user_agent = agent.random()
+
+        # Set headers
+        self.headers = {
+            'Accept': '*/*',
+            'Accept-Language': 'en-US,en;q=0.9',
+            'User-Agent': self.user_agent,
+            'Content-Type': 'application/json',
+        }
+
+        self.session.headers.update(self.headers)
+
+        # Initialize chat interface
+        self.chat = Chat(self)

webscout/Provider/OPENAI/toolbaz.py

@@ -0,0 +1,405 @@
+import time
+import uuid
+import base64
+import json
+import random
+import string
+import re
+import cloudscraper
+from datetime import datetime
+from typing import List, Dict, Optional, Union, Generator, Any
+
+from webscout.litagent import LitAgent
+from .base import BaseChat, BaseCompletions, OpenAICompatibleProvider
+from .utils import (
+    ChatCompletion,
+    ChatCompletionChunk,
+    Choice,
+    ChatCompletionMessage,
+    ChoiceDelta,
+    CompletionUsage,
+    format_prompt,
+    get_system_prompt
+)
+
+# ANSI escape codes for formatting
+BOLD = "\033[1m"
+RED = "\033[91m"
+RESET = "\033[0m"
+
+class Completions(BaseCompletions):
+    def __init__(self, client: 'Toolbaz'):
+        self._client = client
+
+    def create(
+        self,
+        *,
+        model: str,
+        messages: List[Dict[str, str]],
+        max_tokens: Optional[int] = None,
+        stream: bool = False,
+        temperature: Optional[float] = None,
+        top_p: Optional[float] = None,
+        **kwargs: Any
+    ) -> Union[ChatCompletion, Generator[ChatCompletionChunk, None, None]]:
+        """
+        Creates a model response for the given chat conversation.
+        Mimics openai.chat.completions.create
+        """
+        # Format the messages using the format_prompt utility
+        formatted_prompt = format_prompt(messages, add_special_tokens=True, do_continue=True)
+        
+        # Get authentication token
+        auth = self._client.get_auth()
+        if not auth:
+            raise IOError("Failed to authenticate with Toolbaz API")
+
+        # Prepare the request data
+        data = {
+            "text": formatted_prompt,
+            "capcha": auth["token"],
+            "model": model,
+            "session_id": auth["session_id"]
+        }
+
+        # Generate a unique request ID
+        request_id = f"chatcmpl-{uuid.uuid4().hex}"
+        created_time = int(time.time())
+
+        # Handle streaming response
+        if stream:
+            return self._handle_streaming_response(request_id, created_time, model, data)
+        else:
+            return self._handle_non_streaming_response(request_id, created_time, model, data)
+
+    def _handle_streaming_response(
+        self,
+        request_id: str,
+        created_time: int,
+        model: str,
+        data: Dict[str, Any]
+    ) -> Generator[ChatCompletionChunk, None, None]:
+        """Handle streaming response from Toolbaz API"""
+        try:
+            resp = self._client.session.post(
+                "https://data.toolbaz.com/writing.php",
+                data=data,
+                stream=True,
+                proxies=self._client.proxies,
+                timeout=self._client.timeout
+            )
+            resp.raise_for_status()
+
+            buffer = ""
+            tag_start = "[model:"
+            streaming_text = ""
+            
+            for chunk in resp.iter_content(chunk_size=1):
+                if chunk:
+                    text = chunk.decode(errors="ignore")
+                    buffer += text
+                    
+                    # Remove all complete [model: ...] tags in buffer
+                    while True:
+                        match = re.search(r"\[model:.*?\]", buffer)
+                        if not match:
+                            break
+                        buffer = buffer[:match.start()] + buffer[match.end():]
+                    
+                    # Only yield up to the last possible start of a tag
+                    last_tag = buffer.rfind(tag_start)
+                    if last_tag == -1 or last_tag + len(tag_start) > len(buffer):
+                        if buffer:
+                            streaming_text += buffer
+                            
+                            # Create the delta object
+                            delta = ChoiceDelta(
+                                content=buffer,
+                                role="assistant"
+                            )
+                            
+                            # Create the choice object
+                            choice = Choice(
+                                index=0,
+                                delta=delta,
+                                finish_reason=None
+                            )
+                            
+                            # Create the chunk object
+                            chunk = ChatCompletionChunk(
+                                id=request_id,
+                                choices=[choice],
+                                created=created_time,
+                                model=model
+                            )
+                            
+                            yield chunk
+                            buffer = ""
+                    else:
+                        if buffer[:last_tag]:
+                            streaming_text += buffer[:last_tag]
+                            
+                            # Create the delta object
+                            delta = ChoiceDelta(
+                                content=buffer[:last_tag],
+                                role="assistant"
+                            )
+                            
+                            # Create the choice object
+                            choice = Choice(
+                                index=0,
+                                delta=delta,
+                                finish_reason=None
+                            )
+                            
+                            # Create the chunk object
+                            chunk = ChatCompletionChunk(
+                                id=request_id,
+                                choices=[choice],
+                                created=created_time,
+                                model=model
+                            )
+                            
+                            yield chunk
+                        buffer = buffer[last_tag:]
+            
+            # Remove any remaining [model: ...] tag in the buffer
+            buffer = re.sub(r"\[model:.*?\]", "", buffer)
+            if buffer:
+                # Create the delta object
+                delta = ChoiceDelta(
+                    content=buffer,
+                    role="assistant"
+                )
+                
+                # Create the choice object
+                choice = Choice(
+                    index=0,
+                    delta=delta,
+                    finish_reason="stop"
+                )
+                
+                # Create the chunk object
+                chunk = ChatCompletionChunk(
+                    id=request_id,
+                    choices=[choice],
+                    created=created_time,
+                    model=model
+                )
+                
+                yield chunk
+            
+            # Final chunk with finish_reason
+            delta = ChoiceDelta(
+                content=None,
+                role=None
+            )
+            
+            choice = Choice(
+                index=0,
+                delta=delta,
+                finish_reason="stop"
+            )
+            
+            chunk = ChatCompletionChunk(
+                id=request_id,
+                choices=[choice],
+                created=created_time,
+                model=model
+            )
+            
+            yield chunk
+            
+        except Exception as e:
+            print(f"{RED}Error during Toolbaz streaming request: {e}{RESET}")
+            raise IOError(f"Toolbaz streaming request failed: {e}") from e
+
+    def _handle_non_streaming_response(
+        self,
+        request_id: str,
+        created_time: int,
+        model: str,
+        data: Dict[str, Any]
+    ) -> ChatCompletion:
+        """Handle non-streaming response from Toolbaz API"""
+        try:
+            resp = self._client.session.post(
+                "https://data.toolbaz.com/writing.php",
+                data=data,
+                proxies=self._client.proxies,
+                timeout=self._client.timeout
+            )
+            resp.raise_for_status()
+
+            text = resp.text
+            # Remove [model: ...] tags
+            text = re.sub(r"\[model:.*?\]", "", text)
+
+            # Create the message object
+            message = ChatCompletionMessage(
+                role="assistant",
+                content=text
+            )
+            
+            # Create the choice object
+            choice = Choice(
+                index=0,
+                message=message,
+                finish_reason="stop"
+            )
+            
+            # Usage data is not provided by this API in a standard way, set to 0
+            usage = CompletionUsage(prompt_tokens=0, completion_tokens=0, total_tokens=0)
+            
+            # Create the completion object
+            completion = ChatCompletion(
+                id=request_id,
+                choices=[choice],
+                created=created_time,
+                model=model,
+                usage=usage
+            )
+            
+            return completion
+            
+        except Exception as e:
+            print(f"{RED}Error during Toolbaz non-stream request: {e}{RESET}")
+            raise IOError(f"Toolbaz request failed: {e}") from e
+
+class Chat(BaseChat):
+    def __init__(self, client: 'Toolbaz'):
+        self.completions = Completions(client)
+
+class Toolbaz(OpenAICompatibleProvider):
+    """
+    OpenAI-compatible client for Toolbaz API.
+
+    Usage:
+        client = Toolbaz()
+        response = client.chat.completions.create(
+            model="gemini-2.0-flash",
+            messages=[{"role": "user", "content": "Hello!"}]
+        )
+        print(response.choices[0].message.content)
+    """
+
+    AVAILABLE_MODELS = [
+        "gemini-2.0-flash-thinking",
+        "gemini-2.0-flash",
+        "gemini-1.5-flash",
+        "gpt-4o-latest",
+        "gpt-4o-mini",
+        "gpt-4o",
+        "deepseek-r1",
+        "Llama-3.3-70B",
+        "Llama-3.1-405B",
+        "Llama-3.1-70B",
+        "Qwen2.5-72B",
+        "Qwen2-72B",
+        "grok-2-1212",
+        "grok-beta",
+        "toolbaz_v3.5_pro",
+        "toolbaz_v3",
+        "mixtral_8x22b",
+        "L3-70B-Euryale-v2.1",
+        "midnight-rose",
+        "unity",
+        "unfiltered_x"
+    ]
+
+    def __init__(
+        self,
+        api_key: Optional[str] = None,  # Not used but kept for compatibility
+        timeout: int = 30,
+        proxies: dict = {},
+        browser: str = "chrome"
+    ):
+        """
+        Initialize the Toolbaz client.
+
+        Args:
+            api_key: Not used but kept for compatibility with OpenAI interface
+            timeout: Request timeout in seconds
+            proxies: Proxy configuration for requests
+            browser: Browser name for LitAgent to generate User-Agent
+        """
+        self.timeout = timeout
+        self.proxies = proxies
+        
+        # Initialize session with cloudscraper
+        self.session = cloudscraper.create_scraper()
+        
+        # Set up headers
+        self.session.headers.update({
+            "user-agent": LitAgent().generate_fingerprint(browser=browser)["user_agent"],
+            "accept": "*/*",
+            "accept-language": "en-US",
+            "cache-control": "no-cache",
+            "connection": "keep-alive",
+            "content-type": "application/x-www-form-urlencoded; charset=UTF-8",
+            "origin": "https://toolbaz.com",
+            "pragma": "no-cache",
+            "referer": "https://toolbaz.com/",
+            "sec-fetch-mode": "cors"
+        })
+        
+        # Initialize chat property
+        self.chat = Chat(self)
+
+    def random_string(self, length):
+        """Generate a random string of specified length"""
+        return ''.join(random.choices(string.ascii_letters + string.digits, k=length))
+
+    def generate_token(self):
+        """Generate authentication token for Toolbaz API"""
+        payload = {
+            "bR6wF": {
+                "nV5kP": self.session.headers.get("user-agent"),
+                "lQ9jX": "en-US",
+                "sD2zR": "431x958",
+                "tY4hL": time.tzname[0] if time.tzname else "UTC",
+                "pL8mC": "Linux armv81",
+                "cQ3vD": datetime.now().year,
+                "hK7jN": datetime.now().hour
+            },
+            "uT4bX": {
+                "mM9wZ": [],
+                "kP8jY": []
+            },
+            "tuTcS": int(time.time()),
+            "tDfxy": None,
+            "RtyJt": str(uuid.uuid4())
+        }
+        return "d8TW0v" + base64.b64encode(json.dumps(payload).encode()).decode()
+
+    def get_auth(self):
+        """Get authentication credentials for Toolbaz API"""
+        try:
+            session_id = self.random_string(36)
+            token = self.generate_token()
+            data = {
+                "session_id": session_id,
+                "token": token
+            }
+            resp = self.session.post("https://data.toolbaz.com/token.php", data=data)
+            resp.raise_for_status()
+            result = resp.json()
+            if result.get("success"):
+                return {"token": result["token"], "session_id": session_id}
+            return None
+        except Exception as e:
+            print(f"{RED}Error getting Toolbaz authentication: {e}{RESET}")
+            return None
+
+# Example usage
+if __name__ == "__main__":
+    # Test the provider
+    client = Toolbaz()
+    response = client.chat.completions.create(
+        model="gemini-2.0-flash",
+        messages=[
+            {"role": "system", "content": "You are a helpful assistant."},
+            {"role": "user", "content": "Hello! How are you today?"}
+        ]
+    )
+    print(response.choices[0].message.content)