webscout 8.2.2__py3-none-any.whl → 2026.1.19__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/__init__.py

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

webscout/Provider/TTI/talkai/async_talkai.py

@@ -1,229 +0,0 @@
-import uuid
-import json
-import os
-from typing import Any, Dict, List, Union, AsyncGenerator
-import aiohttp
-import asyncio
-import aiofiles
-
-from webscout.AIbase import AsyncImageProvider
-from webscout import exceptions
-from webscout.litagent import agent  # Import our fire user agent generator 🔥
-from webscout.Litlogger import Logger  # For that cyberpunk logging swag ⚡
-
-# Initialize our fire logger 🚀
-logger = Logger("AsyncTalkaiImager")
-
-class AsyncTalkaiImager(AsyncImageProvider):
-    """
-    Async TalkAI Image Provider - Your go-to for fire AI art! 🎨
-    
-    >>> # Generate some fire art asynchronously! 🔥
-    >>> async def generate_art():
-    ...     imager = AsyncTalkaiImager(logging=True)
-    ...     images = await imager.generate("Epic dragon breathing fire", amount=2)
-    ...     paths = await imager.save(images)
-    ...     print(paths)
-    >>> asyncio.run(generate_art())
-    ['epic_dragon_0.png', 'epic_dragon_1.png']
-    
-    >>> # Turn off logging for stealth mode 🥷
-    >>> async def stealth_art():
-    ...     quiet_imager = AsyncTalkaiImager(logging=False)
-    ...     images = await quiet_imager.generate("Cyberpunk city at night")
-    ...     paths = await quiet_imager.save(images)
-    >>> asyncio.run(stealth_art())
-    """
-
-    def __init__(self, timeout: int = 60, proxies: dict = {}, logging: bool = True):
-        """Initialize your async TalkAI provider with custom settings! ⚙️
-
-        Args:
-            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://talkai.info/chat/send/"
-        self.headers = {
-            'accept': 'application/json',
-            'accept-language': 'en-US,en;q=0.9',
-            'content-type': 'application/json',
-            'origin': 'https://talkai.info',
-            'referer': 'https://talkai.info/image/',
-            'user-agent': agent.random(),  # Using our fire random agent! 🔥
-        }
-        self.timeout = timeout
-        self.proxies = proxies
-        self.prompt: str = "AI-generated image - webscout"
-        self.image_extension: str = "png"
-        self.logging = logging
-        if self.logging:
-            logger.info("AsyncTalkaiImager initialized! Ready to create some fire art! 🚀")
-
-    async def generate(
-        self, prompt: str, amount: int = 1,
-        max_retries: int = 3, retry_delay: int = 5
-    ) -> List[str]:
-        """Generate some fire 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
-
-        Returns:
-            List[str]: List of image URLs
-        """
-        assert bool(prompt), "Prompt cannot be empty."
-        assert isinstance(amount, int) and amount > 0, "Amount must be a positive integer."
-
-        self.prompt = prompt
-        image_urls = []
-
-        if self.logging:
-            logger.info(f"Generating {amount} images... 🎨")
-
-        async with aiohttp.ClientSession(headers=self.headers) as session:
-            for _ in range(amount):
-                for attempt in range(max_retries):
-                    try:
-                        async with session.post(
-                            self.api_endpoint,
-                            json=self._create_payload(prompt),
-                            timeout=self.timeout,
-                            proxy=self.proxies.get('http') if self.proxies else None
-                        ) as response:
-                            response.raise_for_status()
-                            data = await response.json()
-
-                            if 'data' in data and len(data['data']) > 0 and 'url' in data['data'][0]:
-                                image_urls.append(data['data'][0]['url'])
-                                if self.logging:
-                                    logger.success(f"Generated image {len(image_urls)}/{amount}! 🎨")
-                                break
-                            else:
-                                raise exceptions.InvalidResponseError("No image URL found in API response.")
-
-                    except aiohttp.ClientError as e:
-                        if attempt == max_retries - 1:
-                            if self.logging:
-                                logger.error(f"Error making API request: {e} 😢")
-                            raise exceptions.APIConnectionError(f"Error making API request: {e}") from e
-                        else:
-                            if self.logging:
-                                logger.warning(f"Attempt {attempt + 1} failed. Retrying in {retry_delay} seconds... 🔄")
-                            await asyncio.sleep(retry_delay)
-                    except json.JSONDecodeError as e:
-                        if self.logging:
-                            logger.error(f"Invalid JSON response: {e} 😢")
-                        raise exceptions.InvalidResponseError(f"Invalid JSON response: {e}") from e
-                    except Exception as e:
-                        if self.logging:
-                            logger.error(f"An unexpected error occurred: {e} 😢")
-                        raise exceptions.FailedToGenerateResponseError(f"An unexpected error occurred: {e}") from e
-
-        if self.logging:
-            logger.success("All images generated successfully! 🎉")
-        return image_urls
-
-    def _create_payload(self, prompt: str) -> Dict[str, Any]:
-        """Create the API request payload 📦
-
-        Args:
-            prompt (str): The image generation prompt
-
-        Returns:
-            Dict[str, Any]: API request payload
-        """
-        return {
-            "type": "image",
-            "messagesHistory": [
-                {
-                    "id": str(uuid.uuid4()),
-                    "from": "you",
-                    "content": prompt
-                }
-            ],
-            "settings": {
-                "model": "gpt-4o-mini"  # Or another suitable model if available
-            }
-        }
-
-    async def save(
-        self,
-        response: Union[List[str], AsyncGenerator[str, None]],
-        name: str = None,
-        dir: str = os.getcwd(),
-        filenames_prefix: str = "",
-    ) -> List[str]:
-        """Save your fire images! 💾
-
-        Args:
-            response (Union[List[str], AsyncGenerator[str, None]]): Image URLs
-            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
-        """
-        if not os.path.exists(dir):
-            os.makedirs(dir)
-            if self.logging:
-                logger.info(f"Created directory: {dir} 📁")
-
-        name = self.prompt if name is None else name
-        saved_paths = []
-
-        async def save_single_image(url: str, index: int) -> str:
-            filename = f"{filenames_prefix}{name}_{index}.{self.image_extension}"
-            filepath = os.path.join(dir, filename)
-            
-            async with aiohttp.ClientSession(headers=self.headers) as session:
-                try:
-                    async with session.get(
-                        url,
-                        timeout=self.timeout,
-                        proxy=self.proxies.get('http') if self.proxies else None
-                    ) as response:
-                        response.raise_for_status()
-                        async with aiofiles.open(filepath, 'wb') as f:
-                            async for chunk in response.content.iter_chunked(8192):
-                                await f.write(chunk)
-                        if self.logging:
-                            logger.success(f"Saved image to: {filepath} 💾")
-                        return filename
-                except aiohttp.ClientError as e:
-                    if self.logging:
-                        logger.error(f"Error downloading image from {url}: {e} 😢")
-                    return None
-
-        if isinstance(response, list):
-            url_list = response
-        else:
-            url_list = [url async for url in response]
-
-        if self.logging:
-            logger.info(f"Saving {len(url_list)} images... 💾")
-
-        tasks = [save_single_image(url, i) for i, url in enumerate(url_list)]
-        saved_paths = await asyncio.gather(*tasks)
-
-        if self.logging:
-            logger.success(f"All images saved successfully! Check {dir} 🎉")
-        return saved_paths
-
-
-if __name__ == "__main__":
-    async def main():
-        bot = AsyncTalkaiImager()
-        try:
-            resp = await bot.generate("A shiny red sports car speeding down a scenic mountain road", 1)
-            paths = await bot.save(resp)
-            print(paths)
-        except Exception as e:
-            if bot.logging:
-                logger.error(f"An error occurred: {e} 😢")
-
-    asyncio.run(main())