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

webscout/Provider/TTI/artbit/sync_artbit.py

@@ -1,148 +0,0 @@
-"""
-ArtbitImager - Your go-to provider for generating fire images with Artbit! 🔥
-
-Examples:
-    >>> from webscout import ArtbitImager
-    >>> 
-    >>> # Initialize provider
-    >>> provider = ArtbitImager()
-    >>> 
-    >>> # Generate a single image
-    >>> images = provider.generate("Cool art")
-    >>> paths = provider.save(images)
-    >>> 
-    >>> # Generate multiple images with parameters
-    >>> images = provider.generate(
-    ...     prompt="Epic dragon in cyberpunk city",
-    ...     amount=3,
-    ...     caption_model="sdxl",
-    ...     selected_ratio="1024",
-    ...     negative_prompt="blurry, bad quality"
-    ... )
-    >>> paths = provider.save(images, name="dragon", dir="outputs")
-"""
-
-import cloudscraper
-import os
-import requests
-from typing import Union, List
-from webscout.AIbase import ImageProvider
-from webscout.litagent import LitAgent
-
-agent = LitAgent()
-
-class ArtbitImager(ImageProvider):
-    """Your go-to provider for generating fire images with Artbit! 🔥"""
-
-    def __init__(self, timeout: int = 60, proxies: dict = {}):
-        """Initialize your Artbit provider with custom settings! ⚙️
-
-        Args:
-            timeout (int): Request timeout in seconds (default: 60)
-            proxies (dict): Proxy settings for requests (default: {})
-        """
-        self.url = "https://artbit.ai/api/generateImage"
-        self.scraper = cloudscraper.create_scraper()
-        self.scraper.headers.update({"User-Agent": agent.random()})
-        self.scraper.proxies.update(proxies)
-        self.timeout = timeout
-        self.prompt: str = "AI-generated image - webscout"
-        self.image_extension: str = "png"
-
-    def generate(
-        self, 
-        prompt: str, 
-        amount: int = 1,
-        caption_model: str = "sdxl",
-        selected_ratio: str = "1024",
-        negative_prompt: str = ""
-    ) -> List[str]:
-        """Generate some fire images! 🎨
-
-        Args:
-            prompt (str): Your lit image description
-            amount (int): How many images to generate (default: 1)
-            caption_model (str): Which model to use (default: "sdxl")
-            selected_ratio (str): Image size ratio (default: "1024")
-            negative_prompt (str): What you don't want in the image (default: "")
-
-        Returns:
-            List[str]: Your generated image URLs
-        """
-        assert bool(prompt), "Yo fam, prompt can't be empty! 🚫"
-        assert isinstance(amount, int), f"Amount gotta be an integer, not {type(amount)} 🤔"
-        assert amount > 0, "Amount gotta be greater than 0! 📈"
-
-        self.prompt = prompt
-        response: List[str] = []
-
-        payload = {
-            "captionInput": prompt,
-            "captionModel": caption_model,
-            "selectedRatio": selected_ratio,
-            "selectedSamples": str(amount),
-            "negative_prompt": negative_prompt
-        }
-
-        try:
-            resp = self.scraper.post(self.url, json=payload, timeout=self.timeout)
-            resp.raise_for_status()
-
-            response_data = resp.json()
-            imgs = response_data.get("imgs", [])
-            
-            if imgs:
-                response.extend(imgs)
-
-        except requests.RequestException as e:
-            raise
-
-        return response
-
-    def save(
-        self,
-        response: List[str],
-        name: str = None,
-        dir: str = os.getcwd(),
-        filenames_prefix: str = "",
-    ) -> List[str]:
-        """Save your fire images! 💾
-
-        Args:
-            response (List[str]): Your image URLs to save
-            name (str, optional): Custom name (default: uses prompt)
-            dir (str, optional): Where to save (default: current directory)
-            filenames_prefix (str, optional): Add prefix to filenames
-
-        Returns:
-            List[str]: Where your images were saved
-        """
-        assert isinstance(response, list), f"Response gotta be a list, not {type(response)} 🤔"
-        name = self.prompt if name is None else name
-
-        filenames = []
-        count = 0
-
-        for img_url 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])
-
-            try:
-                img_response = requests.get(img_url, stream=True, timeout=self.timeout)
-                img_response.raise_for_status()
-
-                with open(absolute_path_to_file, "wb") as fh:
-                    for chunk in img_response.iter_content(chunk_size=8192):
-                        fh.write(chunk)
-
-            except requests.exceptions.RequestException as e:
-                raise
-
-        return filenames

webscout/Provider/TTI/fastflux/__init__.py

@@ -1,22 +0,0 @@
-"""
-FastFlux Image Generator - Your go-to provider for generating fire images! 🔥
-
-Examples:
-    >>> # Sync Usage
-    >>> from webscout import FastFluxImager
-    >>> provider = FastFluxImager()
-    >>> images = provider.generate("Cool art")
-    >>> paths = provider.save(images)
-    >>>
-    >>> # Async Usage
-    >>> from webscout import AsyncFastFluxImager
-    >>> async def example():
-    ...     provider = AsyncFastFluxImager()
-    ...     images = await provider.generate("Epic dragon")
-    ...     paths = await provider.save(images)
-"""
-
-from .sync_fastflux import FastFluxImager
-from .async_fastflux import AsyncFastFluxImager
-
-__all__ = ["FastFluxImager", "AsyncFastFluxImager"]

webscout/Provider/TTI/fastflux/async_fastflux.py

@@ -1,261 +0,0 @@
-"""AsyncFastFluxImager - Generate stunning AI art with FastFlux (async version)! ⚡
-
-Examples:
-    >>> from webscout import AsyncFastFluxImager
-    >>> import asyncio
-    >>> 
-    >>> async def main():
-    ...     provider = AsyncFastFluxImager()
-    ...     # Generate a single image
-    ...     images = await provider.generate("A cool cyberpunk city at night")
-    ...     paths = await provider.save(images, dir="my_images")
-    ...     print(f"Saved images to: {paths}")
-    ... 
-    >>> asyncio.run(main())
-"""
-
-import aiohttp
-import asyncio
-import base64
-import os
-import time
-from typing import List, Optional, Union, AsyncGenerator
-from pathlib import Path
-import aiofiles
-
-from webscout.AIbase import AsyncImageProvider
-from webscout.litagent import LitAgent
-
-class AsyncFastFluxImager(AsyncImageProvider):
-    """Your go-to async provider for generating fire images with FastFlux! ⚡
-
-    Examples:
-        >>> provider = AsyncFastFluxImager()
-        >>> 
-        >>> # Generate one image with default model
-        >>> async def single_image():
-        ...     image = await provider.generate("A futuristic city")
-        ...     await provider.save(image, "city.png")
-        >>> 
-        >>> # Generate multiple with specific model
-        >>> async def multiple_images():
-        ...     images = await provider.generate(
-        ...         prompt="Space station",
-        ...         amount=3,
-        ...         model="flux_1_dev",
-        ...         size="16_9"
-        ...     )
-        ...     await provider.save(images, dir="space_pics")
-    """
-
-    AVAILABLE_MODELS = [
-        "flux_1_schnell",  # Fast generation model (default)
-        "flux_1_dev",      # Developer model
-        "sana_1_6b"        # SANA 1.6B model
-    ]
-    
-    AVAILABLE_SIZES = [
-        "1_1",
-        "16_9",
-        "4_3",
-    ]
-
-    def __init__(self, timeout: int = 60, proxies: dict = None):
-        """Initialize your async FastFluxImager provider with custom settings ⚙️
-
-        Examples:
-            >>> provider = AsyncFastFluxImager(timeout=120)
-            >>> provider = AsyncFastFluxImager(proxies={"http": "http://proxy:8080"})
-
-        Args:
-            timeout (int): HTTP request timeout in seconds (default: 60)
-            proxies (dict, optional): Proxy configuration for requests
-            logging (bool): Enable/disable logging (default: True)
-        """
-        self.api_endpoint = "https://api.fastflux.co/v1/images/generate"
-        self.headers = {
-            "accept": "application/json, text/plain, */*",
-            "content-type": "application/json",
-            "origin": "https://fastflux.co",
-            "referer": "https://fastflux.co/",
-            "user-agent": LitAgent().random()
-        }
-        self.timeout = timeout
-        self.proxies = proxies
-        self.prompt: str = "AI-generated image - webscout"
-        self.image_extension: str = "png"
-        self.logging = True
-
-
-    async def generate(
-        self,
-        prompt: str,
-        amount: int = 1,
-        model: str = "flux_1_schnell",
-        size: str = "1_1",
-        is_public: bool = False,
-        max_retries: int = 3,
-        retry_delay: int = 5
-    ) -> List[bytes]:
-        """Generate some fire images from your prompt asynchronously! ⚡
-
-        Examples:
-            >>> provider = AsyncFastFluxImager()
-            >>> async def example():
-            ...     # Basic usage
-            ...     images = await provider.generate("Cool art")
-            ...     # Advanced usage
-            ...     images = await provider.generate(
-            ...         prompt="Epic dragon",
-            ...         amount=2,
-            ...         model="flux_1_dev",
-            ...         size="16_9"
-            ...     )
-
-        Args:
-            prompt (str): Your image description
-            amount (int): How many images you want (default: 1)
-            model (str): Model to use - check AVAILABLE_MODELS (default: "flux_1_schnell")
-            size (str): Image size ratio (default: "1_1")
-            is_public (bool): Whether to make the image public (default: False)
-            max_retries (int): Max retry attempts if something fails (default: 3)
-            retry_delay (int): Seconds to wait between retries (default: 5)
-
-        Returns:
-            List[bytes]: Your generated images
-
-        Raises:
-            ValueError: If the inputs ain't valid
-            aiohttp.ClientError: If the API calls fail after retries
-        """
-        if not prompt:
-            raise ValueError("Yo fam, the prompt can't be empty! 🤔")
-        if not isinstance(amount, int) or amount < 1:
-            raise ValueError("Amount needs to be a positive number! 📈")
-        if model not in self.AVAILABLE_MODELS:
-            raise ValueError(f"Model must be one of {self.AVAILABLE_MODELS}! 🎯")
-        if size not in self.AVAILABLE_SIZES:
-            raise ValueError(f"Size must be one of {self.AVAILABLE_SIZES}! 📏")
-
-        self.prompt = prompt
-        response = []
-
-        # Prepare payload
-        payload = {
-            "prompt": prompt,
-            "model": model,
-            "size": size,
-            "isPublic": is_public
-        }
-
-
-        async with aiohttp.ClientSession(headers=self.headers) as session:
-            for i in range(amount):
-                for attempt in range(max_retries):
-                    try:                        
-                        async with session.post(
-                            self.api_endpoint,
-                            json=payload,
-                            timeout=self.timeout,
-                            proxy=self.proxies.get('http') if self.proxies else None
-                        ) as resp:
-                            resp.raise_for_status()
-                            result = await resp.json()
-                            
-                            if result and 'result' in result:
-                                # Get base64 data and remove header
-                                image_data = result['result']
-                                base64_data = image_data.split(',')[1]
-                                
-                                # Decode base64 data
-                                image_bytes = base64.b64decode(base64_data)
-                                response.append(image_bytes)
-                                break
-                            else:
-                                raise aiohttp.ClientError("Invalid response format")
-                                
-                    except aiohttp.ClientError as e:
-                        if attempt == max_retries - 1:
-                            raise aiohttp.ClientError(f"Failed to generate image after {max_retries} attempts: {e}")
-                        await asyncio.sleep(retry_delay)
-
-        return response
-
-    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 fire generated images asynchronously! 💾
-
-        Examples:
-            >>> provider = AsyncFastFluxImager()
-            >>> 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
-        
-        # Clean up name for filename use
-        safe_name = "".join(c if c.isalnum() or c in "_-" else "_" for c in name)
-        safe_name = safe_name[:50]  # Truncate if too long
-        
-        # Handle both List[bytes] and AsyncGenerator
-        if isinstance(response, list):
-            image_list = response
-        else:
-            image_list = [chunk async for chunk in response]
-
-
-        async def save_single_image(image_bytes: bytes, index: int) -> str:
-            filename = f"{filenames_prefix}{safe_name}_{index}.{self.image_extension}"
-            filepath = os.path.join(save_dir, filename)
-            
-            async with aiofiles.open(filepath, "wb") as f:
-                await f.write(image_bytes)
-
-            return filename
-
-        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__":
-    # Example usage
-    async def main():
-        provider = AsyncFastFluxImager()
-        try:
-            images = await provider.generate("A cyberpunk city at night with neon lights", amount=1)
-            paths = await provider.save(images, dir="generated_images")
-            print(f"Successfully saved images to: {paths}")
-        except Exception as e:
-            print(f"Oops, something went wrong: {e}")
-
-    asyncio.run(main())

webscout/Provider/TTI/fastflux/sync_fastflux.py

@@ -1,252 +0,0 @@
-"""FastFluxImager Synchronous Provider - Generate stunning AI art with FastFlux! 🎨
-
-Examples:
-    >>> from webscout import FastFluxImager
-    >>> provider = FastFluxImager()
-    >>> 
-    >>> # Generate a single image
-    >>> images = provider.generate("A cool cyberpunk city at night")
-    >>> paths = provider.save(images, dir="my_images")
-    >>> 
-    >>> # Generate multiple images with different settings
-    >>> images = provider.generate(
-    ...     prompt="Epic dragon breathing fire",
-    ...     amount=2, 
-    ...     model="flux_1_schnell"
-    ... )
-    >>> provider.save(images, dir="dragon_pics")
-"""
-
-import requests
-import base64
-import json
-import os
-import time
-from typing import List, Optional, Union
-from requests.exceptions import RequestException
-from pathlib import Path
-
-from webscout.AIbase import ImageProvider
-from webscout.litagent import LitAgent
-
-# Get a fresh user agent! 🔄
-agent = LitAgent()
-
-class FastFluxImager(ImageProvider):
-    """Your go-to provider for generating fire images with FastFlux! 🎨
-
-    Examples:
-        >>> provider = FastFluxImager()
-        >>> # Generate one image with default model
-        >>> image = provider.generate("A futuristic city")
-        >>> provider.save(image, "city.png")
-        >>> 
-        >>> # Generate multiple images with specific model
-        >>> images = provider.generate(
-        ...     prompt="Space station",
-        ...     amount=3,
-        ...     model="flux_1_dev"
-        ... )
-        >>> provider.save(images, dir="space_pics")
-    """
-
-    AVAILABLE_MODELS = [
-        "flux_1_schnell",  # Fast generation model (default)
-        "flux_1_dev",      # Developer model
-        "sana_1_6b"        # SANA 1.6B model
-    ]
-
-    AVAILABLE_SIZES = [
-        "1_1",
-        "16_9",
-        "4_3",
-    ]
-
-    def __init__(self, timeout: int = 60, proxies: dict = None):
-        """Initialize your FastFluxImager provider with custom settings
-
-        Examples:
-            >>> provider = FastFluxImager(timeout=120)
-            >>> provider = FastFluxImager(proxies={"http": "http://proxy:8080"})
-
-        Args:
-            timeout (int): HTTP request timeout in seconds (default: 60)
-            proxies (dict, optional): Proxy configuration for requests
-            logging (bool): Enable/disable logging (default: True)
-        """
-        self.api_endpoint = "https://api.fastflux.co/v1/images/generate"
-        self.headers = {
-            "accept": "application/json, text/plain, */*",
-            "content-type": "application/json",
-            "origin": "https://fastflux.co",
-            "referer": "https://fastflux.co/",
-            "user-agent": agent.random()
-        }
-        self.session = requests.Session()
-        self.session.headers.update(self.headers)
-        if proxies:
-            self.session.proxies.update(proxies)
-        self.timeout = timeout
-        self.prompt: str = "AI-generated image - webscout"
-        self.image_extension: str = "png"
-        self.logging = True
-
-    def generate(
-        self,
-        prompt: str,
-        amount: int = 1,
-        model: str = "flux_1_schnell",
-        size: str = "1_1",
-        is_public: bool = False,
-        max_retries: int = 3,
-        retry_delay: int = 5
-    ) -> List[bytes]:
-        """Generate some fire images from your prompt! 🎨
-
-        Examples:
-            >>> provider = FastFluxImager()
-            >>> # Basic usage
-            >>> images = provider.generate("Cool art")
-            >>> # Advanced usage
-            >>> images = provider.generate(
-            ...     prompt="Epic dragon",
-            ...     amount=2,
-            ...     model="flux_1_dev",
-            ...     size="16_9"
-            ... )
-
-        Args:
-            prompt (str): Your image description
-            amount (int): How many images you want (default: 1)
-            model (str): Model to use - check AVAILABLE_MODELS (default: "flux_1_schnell")
-            size (str): Image size ratio (default: "1_1")
-            is_public (bool): Whether to make the image public (default: False)
-            max_retries (int): Max retry attempts if something fails (default: 3)
-            retry_delay (int): Seconds to wait between retries (default: 5)
-
-        Returns:
-            List[bytes]: Your generated images
-
-        Raises:
-            ValueError: If the inputs ain't valid
-            RequestException: If the API calls fail after retries
-        """
-        if not prompt:
-            raise ValueError("Yo fam, the prompt can't be empty! 🤔")
-        if not isinstance(amount, int) or amount < 1:
-            raise ValueError("Amount needs to be a positive number! 📈")
-        if model not in self.AVAILABLE_MODELS:
-            raise ValueError(f"Model must be one of {self.AVAILABLE_MODELS}! 🎯")
-        if size not in self.AVAILABLE_SIZES:
-            raise ValueError(f"Size must be one of {self.AVAILABLE_SIZES}! 📏")
-
-        self.prompt = prompt
-        response = []
-
-        # Prepare payload
-        payload = {
-            "prompt": prompt,
-            "model": model,
-            "size": size,
-            "isPublic": is_public
-        }
-
-        for i in range(amount):
-            for attempt in range(max_retries):
-                try:
-                    if self.logging:
-                        print(f"Generating image {i+1}/{amount}... 🎨")
-                    
-                    resp = self.session.post(
-                        self.api_endpoint,
-                        json=payload,
-                        timeout=self.timeout
-                    )
-                    resp.raise_for_status()
-                    result = resp.json()
-                    
-                    if result and 'result' in result:
-                        # Get base64 data and remove header
-                        image_data = result['result']
-                        base64_data = image_data.split(',')[1]
-                        
-                        # Decode base64 data
-                        image_bytes = base64.b64decode(base64_data)
-                        response.append(image_bytes)
-
-                        break
-                    else:
-                        raise RequestException("Invalid response format")
-                        
-                except RequestException as e:
-                    if attempt == max_retries - 1:
-                        raise RequestException(f"Failed to generate image after {max_retries} attempts: {e}")
-
-                    time.sleep(retry_delay)
-
-        return response
-
-    def save(
-        self,
-        response: List[bytes],
-        name: Optional[str] = None,
-        dir: Optional[Union[str, Path]] = None,
-        filenames_prefix: str = "",
-    ) -> List[str]:
-        """Save your fire generated images! 💾
-
-        Examples:
-            >>> provider = FastFluxImager()
-            >>> images = provider.generate("Cool art")
-            >>> # Save with default settings
-            >>> paths = provider.save(images)
-            >>> # Save with custom name and directory
-            >>> paths = provider.save(
-            ...     images,
-            ...     name="my_art",
-            ...     dir="my_images",
-            ...     filenames_prefix="test_"
-            ... )
-
-        Args:
-            response (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
-        
-        # Clean up name for filename use
-        safe_name = "".join(c if c.isalnum() or c in "_-" else "_" for c in name)
-        safe_name = safe_name[:50]  # Truncate if too long
-        
-        filenames = []
-
-        for i, image in enumerate(response):
-            filename = f"{filenames_prefix}{safe_name}_{i}.{self.image_extension}"
-            filepath = os.path.join(save_dir, filename)
-            
-            with open(filepath, "wb") as f:
-                f.write(image)
-            
-            filenames.append(filename)
-
-        return filenames
-
-
-if __name__ == "__main__":
-    # Example usage
-    provider = FastFluxImager()
-    try:
-        images = provider.generate("A cyberpunk city at night with neon lights", amount=1)
-        paths = provider.save(images, dir="generated_images")
-        print(f"Successfully saved images to: {paths}")
-    except Exception as e:
-        print(f"Oops, something went wrong: {e}")