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

webscout/Provider/Sambanova.py

@@ -0,0 +1,317 @@
+import json
+from typing import Any, Dict, Generator, List, Optional, Union, cast
+
+from curl_cffi import CurlError
+from curl_cffi.requests import Session
+
+from webscout import exceptions
+from webscout.AIbase import Provider, Response
+from webscout.AIutel import AwesomePrompts, Conversation, Optimizers, sanitize_stream
+from webscout.litagent import LitAgent as Lit
+
+
+class Sambanova(Provider):
+    """
+    A class to interact with the Sambanova API.
+    """
+    required_auth = True
+    AVAILABLE_MODELS = [
+        "DeepSeek-R1",
+        "DeepSeek-V3",
+        "Meta-Llama-3.3-70B-Instruct",
+        "Meta-Llama-3.1-8B-Instruct",
+        "Meta-Llama-3.1-70B-Instruct",
+        "Meta-Llama-3.1-405B-Instruct",
+        "Qwen2.5-72B-Instruct",
+        "Qwen2.5-Coder-32B-Instruct"
+    ]
+
+    def update_available_models(self):
+        """Update the available models list from Sambanova API."""
+        if not self.api_key:
+            return
+
+        try:
+            temp_session = Session()
+            headers = {
+                "Content-Type": "application/json",
+                "Authorization": f"Bearer {self.api_key}",
+            }
+
+            response = temp_session.get(
+                "https://api.sambanova.ai/v1/models",
+                headers=headers,
+                impersonate="chrome120"
+            )
+
+            if response.status_code == 200:
+                data = response.json()
+                if "data" in data and isinstance(data["data"], list):
+                    new_models = [model['id'] for model in data['data'] if 'id' in model]
+                    if new_models:
+                        self.AVAILABLE_MODELS = new_models
+
+        except Exception:
+            pass
+
+    def __init__(
+        self,
+        api_key: Optional[str] = None,
+        is_conversation: bool = True,
+        max_tokens: int = 4096,
+        timeout: int = 30,
+        intro: Optional[str] = None,
+        filepath: Optional[str] = None,
+        update_file: bool = True,
+        proxies: dict = {},
+        history_offset: int = 10250,
+        act: Optional[str] = None,
+        model: str = "Meta-Llama-3.1-8B-Instruct",
+        system_prompt: str = "You are a helpful AI assistant.",
+    ):
+        """
+        Initializes the Sambanova API with given parameters.
+        """
+        self.api_key = api_key
+        self.model = model
+        self.system_prompt = system_prompt
+        self.timeout = timeout
+
+        # Update models list dynamically if API key is provided
+        if api_key:
+            self.update_available_models()
+
+        # Initialize curl_cffi Session
+        self.session = Session()
+        self.is_conversation = is_conversation
+        self.max_tokens_to_sample = max_tokens
+        self.last_response = {}
+
+        self.headers = {
+            "Authorization": f"Bearer {self.api_key}",
+            "Content-Type": "application/json",
+            "User-Agent": Lit().random(),
+        }
+
+        # Update curl_cffi session headers and proxies
+        self.session = Session()
+        self.session.headers.update(self.headers)
+        if proxies:
+            self.session.proxies.update(proxies)
+        self.system_prompt = system_prompt
+
+        self.__available_optimizers = (
+            method
+            for method in dir(Optimizers)
+            if callable(getattr(Optimizers, method)) and not method.startswith("__")
+        )
+        self.conversation = Conversation(
+            is_conversation, self.max_tokens_to_sample, filepath, update_file
+        )
+        self.conversation.history_offset = history_offset
+
+        if act:
+            self.conversation.intro = AwesomePrompts().get_act(cast(Union[str, int], act), default=self.conversation.intro, case_insensitive=True
+            ) or self.conversation.intro
+        elif intro:
+            self.conversation.intro = intro
+
+        # Configure the API base URL
+        self.base_url = "https://api.sambanova.ai/v1/chat/completions"
+
+    def ask(
+        self,
+        prompt: str,
+        stream: bool = False,
+        raw: bool = False,
+        optimizer: Optional[str] = None,
+        conversationally: bool = False,
+        tools: Optional[List[Dict[str, Any]]] = None,
+        tool_choice: Optional[Dict[str, Any]] = None,
+        **kwargs: Any,
+    ) -> Response:
+        """Chat with AI using the Sambanova API."""
+        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 {list(self.__available_optimizers)}"
+                )
+
+        payload = {
+            "model": self.model,
+            "messages": [
+                {"role": "system", "content": self.system_prompt},
+                {"role": "user", "content": conversation_prompt},
+            ],
+            "max_tokens": self.max_tokens_to_sample,
+            "stream": stream
+        }
+
+        if tools:
+            payload["tools"] = tools
+        if tool_choice:
+            payload["tool_choice"] = tool_choice
+
+        def for_stream():
+            try:
+                # Use curl_cffi session post with impersonate
+                response = self.session.post(
+                    self.base_url,
+                    json=payload,
+                    stream=True,
+                    timeout=self.timeout,
+                    impersonate="chrome120"
+                )
+                response.raise_for_status()
+
+                streaming_text = ""
+                processed_stream = sanitize_stream(
+                    data=response.iter_lines(),
+                    intro_value="data:",
+                    to_json=True,
+                    skip_markers=["[DONE]"],
+                    content_extractor=lambda chunk: chunk.get('choices', [{}])[0].get('delta') if isinstance(chunk, dict) else None,
+                    yield_raw_on_error=False,
+                    raw=raw
+                )
+
+                for delta in processed_stream:
+                    if isinstance(delta, dict):
+                        if 'content' in delta and delta['content'] is not None:
+                            content = delta['content']
+                            if raw:
+                                yield content
+                            else:
+                                streaming_text += content
+                                yield {"text": content}
+                        elif 'tool_calls' in delta:
+                            tool_calls = delta['tool_calls']
+                            if raw:
+                                yield json.dumps(tool_calls)
+                            else:
+                                yield {"tool_calls": tool_calls}
+
+                self.last_response.update({"text": streaming_text})
+                if streaming_text:
+                    self.conversation.update_chat_history(prompt, streaming_text)
+
+            except CurlError as e:
+                raise exceptions.ProviderConnectionError(f"Request failed (CurlError): {e}") from e
+            except Exception as e:
+                raise exceptions.ProviderConnectionError(f"Request failed ({type(e).__name__}): {e}") from e
+
+        def for_non_stream():
+            try:
+                payload["stream"] = False
+                response = self.session.post(
+                    self.base_url,
+                    json=payload,
+                    timeout=self.timeout,
+                    impersonate="chrome120"
+                )
+                response.raise_for_status()
+                resp_json = response.json()
+
+                if 'choices' in resp_json and len(resp_json['choices']) > 0:
+                    choice = resp_json['choices'][0]
+                    message = choice.get('message', {})
+                    content = message.get('content', '')
+                    tool_calls = message.get('tool_calls')
+
+                    result = {}
+                    if content:
+                        result["text"] = content
+                    if tool_calls:
+                        result["tool_calls"] = tool_calls
+
+                    self.last_response = result
+                    self.conversation.update_chat_history(prompt, content or "")
+
+                    if raw:
+                        return content if content else (json.dumps(tool_calls) if tool_calls else "")
+                    return result
+                else:
+                    return {}
+
+            except Exception as e:
+                raise exceptions.FailedToGenerateResponseError(f"Non-stream request failed: {e}") from e
+
+        return for_stream() if stream else for_non_stream()
+
+    def chat(
+        self,
+        prompt: str,
+        stream: bool = False,
+        optimizer: Optional[str] = None,
+        conversationally: bool = False,
+        **kwargs: Any,
+    ) -> Union[str, Generator[str, None, None]]:
+        """Generate response `str`"""
+        raw = kwargs.get("raw", False)
+        tools = kwargs.get("tools")
+        tool_choice = kwargs.get("tool_choice")
+
+        def for_stream_chat():
+             # ask() yields dicts or strings when streaming
+             gen = self.ask(
+                 prompt, stream=True, raw=raw,
+                 optimizer=optimizer, conversationally=conversationally,
+                 tools=tools, tool_choice=tool_choice
+             )
+             for response_dict in gen:
+                 if raw:
+                     yield cast(str, response_dict)
+                 else:
+                     yield self.get_message(cast(Response, response_dict))
+
+        def for_non_stream_chat():
+             # ask() returns dict or str when not streaming
+             response_data = self.ask(
+                 prompt,
+                 stream=False,
+                 raw=raw,
+                 optimizer=optimizer,
+                 conversationally=conversationally,
+                 tools=tools,
+                 tool_choice=tool_choice
+             )
+             if raw:
+                 return cast(str, response_data)
+             return self.get_message(response_data)
+
+        return for_stream_chat() if stream else for_non_stream_chat()
+
+    def get_message(self, response: Response) -> str:
+        """
+        Retrieves a clean message from the provided response.
+
+        Args:
+            response: The raw response data.
+
+        Returns:
+            str: The extracted message.
+        """
+        if isinstance(response, str):
+            return response
+        elif isinstance(response, dict):
+            if "text" in response:
+                return response["text"]
+            elif "tool_calls" in response:
+                return json.dumps(response["tool_calls"])
+        return str(response)
+
+if __name__ == "__main__":
+    # Ensure curl_cffi is installed
+    from rich import print
+    ai = Sambanova(api_key='')
+    response = ai.chat(input(">>> "), stream=True)
+    if hasattr(response, "__iter__") and not isinstance(response, (str, bytes)):
+        for chunk in response:
+            print(chunk, end="", flush=True)
+    else:
+        print(response)

webscout/Provider/TTI/README.md

@@ -0,0 +1,69 @@
+# 🖼️ Webscout Text-to-Image (TTI) Providers
+
+Webscout includes a collection of Text-to-Image providers that follow a common interface inspired by the OpenAI Python client. Each provider exposes an `images.create()` method which returns an `ImageResponse` object containing either image URLs or base64 data.
+
+These providers allow you to easily generate AI‑created art from text prompts while handling image conversion and temporary hosting automatically.
+
+## ✨ Features
+
+- **Unified API** – Consistent `images.create()` method for all providers
+- **Multiple Providers** – Generate images using different third‑party services
+- **URL or Base64 Output** – Receive image URLs (uploaded to catbox.moe/0x0.st) or base64 encoded bytes
+- **PNG/JPEG Conversion** – Images are converted in memory to your chosen format
+- **Model Listing** – Query available models with `provider.models.list()`
+
+## 📦 Supported Providers
+
+| Provider         | Available Models (examples)               | Status    |
+| ---------------- | ----------------------------------------- | --------- |
+| `PollinationsAI` | `flux`, `flux-pro`, `turbo`, `gptimage`   | Working   |
+| `MagicStudioAI`  | `magicstudio`                             | Working   |
+| `ClaudeOnlineTTI`| `claude-imagine`                          | Working   |
+| `TogetherImage`  | `flux.1-schnell`, `flux.1-pro`            | Working*  |
+
+\* Requires authentication (API keys).
+
+> **Note**: Some providers require the `Pillow` package for image processing.
+
+## 🚀 Quick Start
+
+```python
+from webscout.Provider.TTI import PollinationsAI
+
+# Initialize the provider
+client = PollinationsAI()
+
+# Generate two images and get URLs
+response = client.images.create(
+    model="flux",
+    prompt="A futuristic city skyline at sunset",
+    n=2,
+    response_format="url"
+)
+
+print(response)
+```
+
+### Base64 Output
+
+If you prefer the raw image data:
+
+```python
+response = client.images.create(
+    model="flux",
+    prompt="Crystal mountain landscape",
+    response_format="b64_json"
+)
+# `response.data` will contain base64 strings
+```
+
+## 🔧 Provider Specifics
+
+- **PollinationsAI** – Allows setting a custom seed for reproducible results.
+- **MagicStudioAI** – Generates images through MagicStudio's public endpoint.
+- **ClaudeOnlineTTI** – Uses Pollinations.ai backend to provide image generation capabilities.
+- **TogetherImage** – High-quality image generation via Together.xyz API (Requires API Key).
+
+## 🤝 Contributing
+
+Contributions and additional providers are welcome! Feel free to submit a pull request.

webscout/Provider/TTI/__init__.py

@@ -1,12 +1,37 @@
-from .FreeAIPlayground import *
-from .PollinationsAI import *
-from .AiForce import *
-from .Nexra import *
-from .huggingface import *
-from .artbit import *
-from .talkai import *
-from .piclumen import *
-from .MagicStudio import *
-from .fastflux import *
-from .pixelmuse import *
-from .ImgSys import *
+# This file marks the directory as a Python package.
+# Static imports for all TTI (Text-to-Image) provider modules
+
+# Base classes
+from webscout.Provider.TTI.base import (
+    BaseImages,
+    TTICompatibleProvider,
+)
+
+# Provider implementations
+from webscout.Provider.TTI.claudeonline import ClaudeOnlineTTI
+from webscout.Provider.TTI.magicstudio import MagicStudioAI
+from webscout.Provider.TTI.miragic import MiragicAI
+from webscout.Provider.TTI.pollinations import PollinationsAI
+from webscout.Provider.TTI.together import TogetherImage
+
+# Utility classes
+from webscout.Provider.TTI.utils import (
+    ImageData,
+    ImageResponse,
+)
+
+# List of all exported names
+__all__ = [
+    # Base classes
+    "TTICompatibleProvider",
+    "BaseImages",
+    # Utilities
+    "ImageData",
+    "ImageResponse",
+    # Providers
+    "ClaudeOnlineTTI",
+    "MagicStudioAI",
+    "PollinationsAI",
+    "TogetherImage",
+    "MiragicAI",
+]

webscout/Provider/TTI/base.py

@@ -0,0 +1,147 @@
+from abc import ABC, abstractmethod
+from typing import Any, List, Optional, Union, cast
+
+from .utils import ImageResponse
+
+
+class BaseImages(ABC):
+    @abstractmethod
+    def create(
+        self,
+        *,
+        model: str,
+        prompt: str,
+        n: int = 1,
+        size: str = "1024x1024",
+        response_format: str = "url",
+        user: Optional[str] = None,
+        style: str = "none",
+        aspect_ratio: str = "1:1",
+        timeout: Optional[int] = None,
+        image_format: str = "png",
+        seed: Optional[int] = None,
+        convert_format: bool = False,
+        **kwargs,
+    ) -> ImageResponse:
+        """
+        Abstract method to create images from a prompt.
+
+        Args:
+            model: The model to use for image generation.
+            prompt: The prompt for the image.
+            n: Number of images to generate.
+            size: Image size.
+            response_format: "url" or "b64_json".
+            user: Optional user identifier.
+            style: Optional style.
+            aspect_ratio: Optional aspect ratio.
+            timeout: Request timeout in seconds.
+            image_format: "png" or "jpeg" for output format.
+            seed: Optional random seed for reproducibility.
+            **kwargs: Additional provider-specific parameters.
+
+        Returns:
+            ImageResponse: The generated images.
+        """
+        raise NotImplementedError
+
+
+# class ProxyAutoMeta(ABCMeta):
+#     """Metaclass providing seamless proxy injection for providers."""
+
+#     def __call__(cls, *args, **kwargs):
+#         # Determine if automatic proxying should be disabled
+#         disable_auto_proxy = kwargs.get('disable_auto_proxy', False) or getattr(cls, 'DISABLE_AUTO_PROXY', False)
+
+#         # Proxies may be supplied explicitly
+#         proxies = kwargs.get('proxies', None)
+
+#         # Otherwise try to fetch one automatically
+#         if proxies is None and not disable_auto_proxy:
+#             try:
+#                 proxies = {"http": get_auto_proxy(), "https": get_auto_proxy()}
+#             except Exception as e:
+#                 print(f"Failed to fetch auto-proxy: {e}")
+#                 proxies = {}
+#         elif proxies is None:
+#             proxies = {}
+
+#         # No global monkeypatching, just set proxies on the instance
+#         instance = super().__call__(*args, **kwargs)
+#         instance.proxies = proxies
+
+#         # If proxies are set, patch any existing session-like attributes
+#         if proxies:
+#             for attr in dir(instance):
+#                 obj = getattr(instance, attr)
+#                 if isinstance(obj, requests.Session):
+#                     obj.proxies.update(proxies)
+#                 if CurlSession and isinstance(obj, CurlSession):
+#                     try:
+#                         obj.proxies.update(proxies)
+#                     except (ValueError, KeyError, AttributeError):
+#                         print("Failed to update proxies for CurlSession due to an expected error.")
+#                 if CurlAsyncSession and isinstance(obj, CurlAsyncSession):
+#                     try:
+#                         obj.proxies.update(proxies)
+#                     except (ValueError, KeyError, AttributeError):
+#                         print("Failed to update proxies for CurlAsyncSession due to an expected error.")
+
+#         # Helper for backward compatibility
+#         def get_proxied_session():
+#             s = requests.Session()
+#             s.proxies.update(proxies)
+#             return s
+
+#         instance.get_proxied_session = get_proxied_session
+
+#         def get_proxied_curl_session(impersonate="chrome120", **kw):
+#             if CurlSession:
+#                 return CurlSession(proxies=proxies, impersonate=impersonate, **kw)
+#             raise ImportError("curl_cffi is not installed")
+
+#         instance.get_proxied_curl_session = get_proxied_curl_session
+
+#         def get_proxied_curl_async_session(impersonate="chrome120", **kw):
+#             if CurlAsyncSession:
+#                 return CurlAsyncSession(proxies=proxies, impersonate=impersonate, **kw)
+#             raise ImportError("curl_cffi is not installed")
+
+#         instance.get_proxied_curl_async_session = get_proxied_curl_async_session
+
+#         return instance
+
+
+class TTICompatibleProvider(ABC):
+    """
+    Abstract Base Class for TTI providers mimicking the OpenAI Python client structure.
+    Requires a nested 'images.create' structure.
+    All subclasses automatically get proxy support via ProxyAutoMeta.
+
+    Class Attributes:
+        required_auth (bool): Whether this provider requires authentication (API key, cookie, etc.)
+        working (bool): Whether this provider is currently working/operational
+
+    Available proxy helpers:
+    - self.get_proxied_session() - returns a requests.Session with proxies
+    - self.get_proxied_curl_session() - returns a curl_cffi.Session with proxies
+    - self.get_proxied_curl_async_session() - returns a curl_cffi.AsyncSession with proxies
+    """
+
+    images: BaseImages
+    required_auth: bool = False  # Default: no auth required
+    working: bool = True  # Default: provider is working
+    AVAILABLE_MODELS: List[str] = []  # List of available models
+
+    @abstractmethod
+    def __init__(self, **kwargs: Any):
+        pass
+
+    @property
+    @abstractmethod
+    def models(self) -> Any:
+        """
+        Property that returns an object with a .list() method returning available models.
+        Subclasses must implement this property.
+        """
+        raise NotImplementedError