webscout 8.2.8__py3-none-any.whl → 8.3__py3-none-any.whl

webscout/Provider/TTI/pixelmuse/async_pixelmuse.py

@@ -1,249 +0,0 @@
-import aiohttp
-import asyncio
-import os
-import time
-from typing import List, Optional, Union, AsyncGenerator
-from string import punctuation
-from random import choice
-from aiohttp import ClientError
-from pathlib import Path
-
-from webscout.AIbase import AsyncImageProvider
-from webscout.litagent import LitAgent
-
-agent = LitAgent()
-
-class AsyncPixelMuseImager(AsyncImageProvider):
-    """Your go-to async provider for generating fire images with PixelMuse! ⚡
-
-    Examples:
-        >>> # Basic usage
-        >>> provider = AsyncPixelMuseImager()
-        >>> async def example():
-        ...     images = await provider.generate("Cool art")
-        ...     paths = await provider.save(images)
-        >>>
-        >>> # Advanced usage
-        >>> provider = AsyncPixelMuseImager(timeout=120)
-        >>> async def example():
-        ...     images = await provider.generate(
-        ...         prompt="Epic dragon",
-        ...         amount=3,
-        ...         model="flux-schnell",
-        ...         style="none",
-        ...         aspect_ratio="1:1"
-        ...     )
-        ...     paths = await provider.save(images, name="dragon", dir="my_art")
-    """
-
-    AVAILABLE_MODELS = [
-        "flux-schnell",
-        "imagen-3-fast",
-        "imagen-3",
-        "recraft-v3"
-    ]
-
-    def __init__(self, timeout: int = 60, proxies: dict = {}):
-        """Initialize your async PixelMuse provider with custom settings! ⚙️
-
-        Args:
-            timeout (int): Request timeout in seconds (default: 60)
-            proxies (dict): Proxy settings for requests (default: {})
-        """
-        self.api_endpoint = "https://www.pixelmuse.studio/api/predictions"
-        self.headers = {
-            "accept": "*/*",
-            "accept-language": "en-US,en;q=0.9",
-            "content-type": "application/json",
-            "origin": "https://www.pixelmuse.studio",
-            "referer": "https://www.pixelmuse.studio/",
-            "sec-ch-ua": '"Chromium";v="134", "Not:A-Brand";v="24", "Google Chrome";v="134"',
-            "sec-ch-ua-mobile": "?0",
-            "sec-ch-ua-platform": '"Windows"',
-            "sec-fetch-dest": "empty",
-            "sec-fetch-mode": "cors",
-            "sec-fetch-site": "same-origin",
-            "user-agent": agent.random(),
-        }
-        self.timeout = timeout
-        self.proxies = proxies
-        self.prompt: str = "AI-generated image - webscout"
-        self.image_extension: str = "webp"
-
-    async def generate(
-        self, 
-        prompt: str, 
-        amount: int = 1,
-        max_retries: int = 3, 
-        retry_delay: int = 5,
-        model: str = "flux-schnell",
-        style: str = "none", 
-        aspect_ratio: str = "1:1"
-    ) -> List[bytes]:
-        """Generate some amazing images from your prompt asynchronously! ⚡
-
-        Examples:
-            >>> provider = AsyncPixelMuseImager()
-            >>> async def example():
-            ...     # Basic usage
-            ...     images = await provider.generate("Cool art")
-            ...     # Advanced usage
-            ...     images = await provider.generate(
-            ...         prompt="Epic dragon",
-            ...         amount=3,
-            ...         model="flux-schnell"
-            ...     )
-
-        Args:
-            prompt (str): Your creative prompt
-            amount (int): How many images to generate
-            max_retries (int): Max retry attempts if generation fails
-            retry_delay (int): Seconds to wait between retries
-            model (str): Model to use - check AVAILABLE_MODELS (default: "flux-schnell")
-            style (str): Style to apply (default: "none")
-            aspect_ratio (str): Aspect ratio (default: "1:1")
-
-        Returns:
-            List[bytes]: Your generated images
-
-        Raises:
-            ValueError: If the inputs ain't valid
-            ClientError: If the API calls fail after retries
-        """
-        assert bool(prompt), "Prompt cannot be null"
-        assert isinstance(amount, int), f"Amount should be an integer only not {type(amount)}"
-        assert amount > 0, "Amount should be greater than 0"
-        assert model in self.AVAILABLE_MODELS, f"Model should be one of {self.AVAILABLE_MODELS}"
-
-        self.prompt = prompt
-        response = []
-        
-        async with aiohttp.ClientSession(headers=self.headers) as session:
-            for _ in range(amount):
-                for attempt in range(max_retries):
-                    try:
-                        # First request to get the prediction
-                        async with session.post(
-                            self.api_endpoint,
-                            json=self._create_payload(prompt, model, style, aspect_ratio),
-                            timeout=self.timeout,
-                            proxy=self.proxies.get('http')
-                        ) as resp:
-                            resp.raise_for_status()
-                            data = await resp.json()
-
-                            if 'output' in data and len(data['output']) > 0:
-                                image_url = data['output'][0]
-                                # Get the image data from the URL
-                                async with session.get(
-                                    image_url, 
-                                    timeout=self.timeout,
-                                    proxy=self.proxies.get('http')
-                                ) as img_resp:
-                                    img_resp.raise_for_status()
-                                    response.append(await img_resp.read())
-                                    break
-                            else:
-                                print(f"Warning: No image data in response: {data}")
-                                if attempt == max_retries - 1:
-                                    raise Exception("No image data received after all retries")
-
-                    except ClientError as e:
-                        if attempt == max_retries - 1:
-                            raise
-                        else:
-                            await asyncio.sleep(retry_delay)
-
-        return response
-
-    def _create_payload(self, prompt: str, model: str, style: str, aspect_ratio: str) -> dict:
-        """Create the API request payload 📦
-
-        Args:
-            prompt (str): The image generation prompt
-            model (str): Model to use
-            style (str): Style to apply
-            aspect_ratio (str): Aspect ratio
-
-        Returns:
-            dict: API request payload
-        """
-        return {
-            "prompt": prompt,
-            "model": model,
-            "style": style,
-            "aspect_ratio": aspect_ratio
-        }
-
-    async def save(
-        self,
-        response: Union[AsyncGenerator[bytes, None], List[bytes]],
-        name: Optional[str] = None,
-        dir: Optional[Union[str, Path]] = None,
-        filenames_prefix: str = "",
-    ) -> List[str]:
-        """Save your amazing images asynchronously! 💾
-
-        Examples:
-            >>> provider = AsyncPixelMuseImager()
-            >>> async def example():
-            ...     images = await provider.generate("Cool art")
-            ...     # Save with default settings
-            ...     paths = await provider.save(images)
-            ...     # Save with custom name and directory
-            ...     paths = await provider.save(
-            ...         images,
-            ...         name="my_art",
-            ...         dir="my_images",
-            ...         filenames_prefix="test_"
-            ...     )
-
-        Args:
-            response (Union[AsyncGenerator[bytes, None], List[bytes]]): Your generated images
-            name (Optional[str]): Custom name for your images
-            dir (Optional[Union[str, Path]]): Where to save the images (default: current directory)
-            filenames_prefix (str): Prefix for your image files
-
-        Returns:
-            List[str]: Paths to your saved images
-        """
-        save_dir = dir if dir else os.getcwd()
-        if not os.path.exists(save_dir):
-            os.makedirs(save_dir)
-
-        name = self.prompt if name is None else name
-        saved_paths = []
-        timestamp = int(time.time())
-        
-        async def save_single_image(image_bytes: bytes, index: int) -> str:
-            filename = f"{filenames_prefix}{name}_{index}.{self.image_extension}"
-            filepath = os.path.join(save_dir, filename)
-            
-            # Write file using asyncio
-            async with asyncio.Lock():
-                with open(filepath, "wb") as f:
-                    f.write(image_bytes)
-            
-            return filepath
-
-        # Handle both List[bytes] and AsyncGenerator
-        if isinstance(response, list):
-            image_list = response
-        else:
-            image_list = [chunk async for chunk in response]
-
-        tasks = [save_single_image(img, i) for i, img in enumerate(image_list)]
-        saved_paths = await asyncio.gather(*tasks)
-        return saved_paths
-
-if __name__ == "__main__":
-    async def main():
-        bot = AsyncPixelMuseImager()
-        try:
-            resp = await bot.generate("A magical forest with glowing mushrooms and fairy lights", 1)
-            paths = await bot.save(resp)
-            print(paths)
-        except Exception as e:
-            print(f"An error occurred: {e}")
-
-    asyncio.run(main()) 

webscout/Provider/TTI/pixelmuse/sync_pixelmuse.py

@@ -1,182 +0,0 @@
-import requests
-import os
-from typing import Union, List
-from string import punctuation
-from random import choice
-
-from webscout.AIbase import ImageProvider
-from webscout.litagent import LitAgent
-
-class PixelMuseImager(ImageProvider):
-    """
-    PixelMuse Image Provider - Create stunning AI art with PixelMuse! 🎨
-    """
-    
-    AVAILABLE_MODELS = [
-        "flux-schnell",
-        "imagen-3-fast",
-        "imagen-3",
-        "recraft-v3"
-    ]
-
-    def __init__(
-        self,
-        model: str = "flux-schnell",
-        timeout: int = 60,
-        proxies: dict = {},
-    ):
-        """Initialize your PixelMuse provider with custom settings! ⚙️
-
-        Args:
-            model (str): Which model to use (default: flux-schnell)
-            timeout (int): Request timeout in seconds (default: 60)
-            proxies (dict): Proxy settings for requests (default: {})
-            logging (bool): Enable fire logging (default: True)
-        """
-        self.api_endpoint = "https://www.pixelmuse.studio/api/predictions"
-        self.headers = {
-            "accept": "*/*",
-            "accept-language": "en-US,en;q=0.9",
-            "content-type": "application/json",
-            "origin": "https://www.pixelmuse.studio",
-            "referer": "https://www.pixelmuse.studio/",
-            "sec-ch-ua": '"Chromium";v="134", "Not:A-Brand";v="24", "Google Chrome";v="134"',
-            "sec-ch-ua-mobile": "?0",
-            "sec-ch-ua-platform": '"Windows"',
-            "sec-fetch-dest": "empty",
-            "sec-fetch-mode": "cors",
-            "sec-fetch-site": "same-origin",
-            "user-agent": LitAgent().random(),
-        }
-        self.session = requests.Session()
-        self.session.headers.update(self.headers)
-        self.session.proxies.update(proxies)
-        self.timeout = timeout
-        self.model = model
-        self.prompt: str = "AI-generated image - webscout"
-        self.image_extension: str = "webp"
-
-    def generate(
-        self, prompt: str, amount: int = 1,
-        max_retries: int = 3, retry_delay: int = 5,
-        style: str = "none", aspect_ratio: str = "1:1"
-    ) -> List[bytes]:
-        """Generate some amazing images from your prompt! 🎨
-
-        Args:
-            prompt (str): Your creative prompt
-            amount (int): How many images to generate
-            max_retries (int): Max retry attempts if generation fails
-            retry_delay (int): Seconds to wait between retries
-            style (str): Style to apply (default: "none")
-            aspect_ratio (str): Aspect ratio (default: "1:1")
-
-        Returns:
-            List[bytes]: Your generated images as bytes
-        """
-        assert bool(prompt), "Prompt cannot be empty."
-        assert isinstance(amount, int) and amount > 0, "Amount must be a positive integer."
-
-        self.prompt = prompt
-        response = []
-        
-        for _ in range(amount):
-            for attempt in range(max_retries):
-                try:
-                    with self.session.post(
-                        self.api_endpoint,
-                        json=self._create_payload(prompt, self.model, style, aspect_ratio),
-                        timeout=self.timeout
-                    ) as resp:
-                        resp.raise_for_status()
-                        data = resp.json()
-
-                        if 'output' in data and len(data['output']) > 0:
-                            image_url = data['output'][0]
-                            # Get the image data from the URL
-                            img_resp = self.session.get(image_url, timeout=self.timeout)
-                            img_resp.raise_for_status()
-                            response.append(img_resp.content)
-                            break
-                        else:
-                            print(f"Warning: No image data in response: {data}")
-                            if attempt == max_retries - 1:
-                                raise Exception("No image data received after all retries")
-
-                except Exception as e:
-                    print(f"Error generating image (attempt {attempt + 1}/{max_retries}): {str(e)}")
-                    if attempt == max_retries - 1:
-                        raise
-                    import time
-                    time.sleep(retry_delay)
-
-        return response
-
-    def _create_payload(self, prompt: str, model: str, style: str, aspect_ratio: str) -> dict:
-        """Create the API request payload 📦
-
-        Args:
-            prompt (str): The image generation prompt
-            model (str): Model to use
-            style (str): Style to apply
-            aspect_ratio (str): Aspect ratio
-
-        Returns:
-            dict: API request payload
-        """
-        return {
-            "prompt": prompt,
-            "model": model,
-            "style": style,
-            "aspect_ratio": aspect_ratio
-        }
-
-    def save(
-        self,
-        response: List[bytes],
-        name: str = None,
-        dir: str = os.getcwd(),
-        filenames_prefix: str = "",
-    ) -> List[str]:
-        """Save your amazing images! 💾
-
-        Args:
-            response (List[bytes]): List of image data
-            name (str, optional): Base name for saved files
-            dir (str, optional): Where to save the images
-            filenames_prefix (str, optional): Prefix for filenames
-
-        Returns:
-            List[str]: List of saved filenames
-        """
-        assert isinstance(response, list), f"Response should be of {list} not {type(response)}"
-        name = self.prompt if name is None else name
-
-        if not os.path.exists(dir):
-            os.makedirs(dir)
-
-        filenames = []
-        count = 0
-        for image in response:
-            def complete_path():
-                count_value = "" if count == 0 else f"_{count}"
-                return os.path.join(dir, name + count_value + "." + self.image_extension)
-
-            while os.path.isfile(complete_path()):
-                count += 1
-
-            absolute_path_to_file = complete_path()
-            filenames.append(filenames_prefix + os.path.split(absolute_path_to_file)[1])
-
-            with open(absolute_path_to_file, "wb") as fh:
-                fh.write(image)
-        return filenames
-
-
-if __name__ == "__main__":
-    bot = PixelMuseImager()
-    try:
-        resp = bot.generate("A magical forest with glowing mushrooms and fairy lights", 1)
-        print(bot.save(resp))
-    except Exception:
-        pass 

webscout/Provider/TTI/talkai/README.md

@@ -1,139 +0,0 @@
-# 🎨 TalkaiImager - Fire AI Art Generator! 🔥
-
-Yo fam! Welcome to TalkaiImager - your go-to provider for creating some absolutely fire AI art! 🎨
-
-## 🚀 Features
-
-- Both sync and async support for maximum flexibility 💪
-- Fire error handling for smooth operation 🛡️
-- Optional logging with cyberpunk vibes 🌟
-- Dynamic user agents for stealth mode 🥷
-- Proxy support for extra privacy 🔒
-- Customizable timeouts and retries ⚙️
-- Smart retry mechanism 🔄
-
-## 💫 Installation
-
-```bash
-pip install webscout  # All you need fam! 🔥
-```
-
-## 🎯 Usage
-
-### 🔥 Sync Way (TalkaiImager)
-
-```python
-from webscout import TalkaiImager
-
-# Initialize with fire logging! 🚀
-imager = TalkaiImager(logging=True)
-
-# Generate a single image
-images = imager.generate("Epic dragon breathing fire")
-paths = imager.save(images)
-print(paths)  # ['epic_dragon_0.png']
-
-# Generate multiple images with retries
-images = imager.generate(
-    "Cyberpunk city at night",
-    amount=3,
-    max_retries=5,
-    retry_delay=3
-)
-paths = imager.save(images)
-print(paths)  # ['cyberpunk_city_0.png', 'cyberpunk_city_1.png', 'cyberpunk_city_2.png']
-
-# Stealth mode (no logging)
-quiet_imager = TalkaiImager(logging=False)
-images = quiet_imager.generate("Secret art")
-paths = quiet_imager.save(images)
-```
-
-### ⚡ Async Way (AsyncTalkaiImager)
-
-```python
-from webscout import AsyncTalkaiImager
-import asyncio
-
-async def generate_art():
-    # Initialize with fire logging! 🚀
-    imager = AsyncTalkaiImager(logging=True)
-    
-    # Generate multiple images
-    images = await imager.generate(
-        "Epic dragon breathing fire",
-        amount=2,
-        max_retries=3,
-        retry_delay=5
-    )
-    paths = await imager.save(images)
-    print(paths)  # ['epic_dragon_0.png', 'epic_dragon_1.png']
-
-    # Custom save location
-    images = await imager.generate("Cool art")
-    paths = await imager.save(images, dir="my_art", filenames_prefix="fire_")
-
-# Run it!
-asyncio.run(generate_art())
-```
-
-### 🛠️ Advanced Usage
-
-```python
-# With proxy and custom timeout
-imager = TalkaiImager(
-    timeout=120,
-    proxies={
-        'http': 'http://10.10.10.1:8000',
-        'https': 'http://10.10.10.1:8000'
-    },
-    logging=True
-)
-
-# Custom save options
-images = imager.generate(
-    "Cool art",
-    max_retries=5,
-    retry_delay=3
-)
-paths = imager.save(
-    images,
-    name="masterpiece",
-    dir="my_art_folder",
-    filenames_prefix="fire_"
-)
-```
-
-## ⚡ Error Handling
-
-We got your back with proper error handling:
-
-```python
-try:
-    images = imager.generate("Cool art")
-    paths = imager.save(images)
-except exceptions.APIConnectionError as e:
-    print("Connection issues! Check your internet! 🌐")
-except exceptions.InvalidResponseError as e:
-    print("Invalid response from API! 🚫")
-except exceptions.FailedToGenerateResponseError as e:
-    print("Failed to generate image! 😢")
-except Exception as e:
-    print(f"Something went wrong fam: {e} 😢")
-```
-
-## 🔒 Security Tips
-
-- Use proxies for extra privacy 🛡️
-- Enable stealth mode (logging=False) for sensitive ops 🤫
-- Don't expose sensitive info in prompts 🔐
-- Use custom timeouts for stability 🕒
-
-## 🎛️ Parameters Guide
-
-- `amount`: Number of images to generate (default: 1)
-- `max_retries`: Number of retry attempts (default: 3)
-- `retry_delay`: Seconds between retries (default: 5)
-- `timeout`: Request timeout in seconds (default: 60)
-
-Made with 💖 by the HelpingAI Team! Keep it real fam! 🔥👑

webscout/Provider/TTI/talkai/__init__.py

@@ -1,4 +0,0 @@
-from .sync_talkai import TalkaiImager
-from .async_talkai import AsyncTalkaiImager
-
-__all__ = ["TalkaiImager", "AsyncTalkaiImager"]