webscout 6.3__py3-none-any.whl → 6.4__py3-none-any.whl

webscout/Provider/TTI/PollinationsAI/sync_pollinations.py

@@ -0,0 +1,285 @@
+"""PollinationsAI Synchronous Provider - Your go-to for text-to-image generation! 🔥
+
+Examples:
+    >>> from webscout import PollinationsAI
+    >>> provider = PollinationsAI()
+    >>> 
+    >>> # Generate a single image
+    >>> images = provider.generate("A cool cyberpunk city at night")
+    >>> provider.save(images, dir="my_images")
+    >>> 
+    >>> # Generate multiple images with different settings
+    >>> images = provider.generate(
+    ...     prompt="A majestic dragon", 
+    ...     amount=3,
+    ...     width=1024,
+    ...     height=1024,
+    ...     model="sdxl"
+    ... )
+"""
+
+import requests
+import os
+import time
+from typing import List, Optional, Union
+from string import punctuation
+from random import choice
+from requests.exceptions import RequestException
+from pathlib import Path
+
+from webscout.AIbase import ImageProvider
+from webscout.Litlogger import LitLogger, LogFormat, ColorScheme
+from webscout.litagent import LitAgent
+
+# Set up logging with cyberpunk style! 🎨
+logger = LitLogger(
+    name="PollinationsAI",
+    format=LogFormat.MODERN_EMOJI,
+    color_scheme=ColorScheme.CYBERPUNK
+)
+
+# Get a fresh user agent! 🔄
+agent = LitAgent()
+
+class PollinationsAI(ImageProvider):
+    """Your homie for generating fire images using pollinations.ai! 🎨
+
+    This provider supports various models and image sizes, with built-in retry logic
+    and error handling to make sure you get your images no cap! 💯
+
+    Examples:
+        >>> provider = PollinationsAI()
+        >>> # Generate one image with default model
+        >>> image = provider.generate("A futuristic city")
+        >>> provider.save(image, "city.jpg")
+        >>> 
+        >>> # Generate multiple with specific model
+        >>> images = provider.generate(
+        ...     prompt="Space station",
+        ...     amount=3,
+        ...     width=1024,
+        ...     height=1024,
+        ...     model="flux-3d"  # For 3D-style images
+        ... )
+        >>> provider.save(images, dir="space_pics")
+        >>>
+        >>> # Try different models
+        >>> anime_pics = provider.generate(
+        ...     prompt="Anime character",
+        ...     model="flux-anime"
+        ... )
+        >>> realistic_pics = provider.generate(
+        ...     prompt="Portrait photo",
+        ...     model="flux-realism"
+        ... )
+
+    Attributes:
+        AVAILABLE_MODELS (list): Available models to use:
+            - "flux": Default model, good for general use
+            - "flux-realism": Enhanced realism
+            - "flux-cablyai": CablyAI style
+            - "flux-anime": Anime/manga style
+            - "flux-3d": 3D-style renders
+            - "any-dark": Dark/gothic style
+            - "flux-pro": Professional quality
+            - "turbo": Fast generation
+        DEFAULT_MODEL (str): Default model to use ("flux")
+    """
+
+    AVAILABLE_MODELS = [
+        "flux",
+        "flux-realism",
+        "flux-cablyai",
+        "flux-anime",
+        "flux-3d",
+        "any-dark",
+        "flux-pro",
+        "turbo"
+    ]
+    DEFAULT_MODEL = "flux"
+
+    def __init__(
+        self, 
+        timeout: int = 60, 
+        proxies: Optional[dict] = None
+    ):
+        """Initialize your PollinationsAI provider with custom settings
+
+        Examples:
+            >>> provider = PollinationsAI(timeout=30)
+            >>> provider = PollinationsAI(proxies={"http": "http://proxy:8080"})
+
+        Args:
+            timeout (int): HTTP request timeout in seconds (default: 60)
+            proxies (dict, optional): Proxy configuration for requests
+        """
+        self.image_gen_endpoint = "https://image.pollinations.ai/prompt/{prompt}"
+        self.headers = {
+            "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
+            "Accept-Language": "en-US,en;q=0.5",
+            "Accept-Encoding": "gzip, deflate",
+            "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 = "jpeg"
+
+    def generate(
+        self,
+        prompt: str,
+        amount: int = 1,
+        additives: bool = True,
+        width: int = 768,
+        height: int = 768,
+        model: str = DEFAULT_MODEL,
+        max_retries: int = 3,
+        retry_delay: int = 5,
+        negative_prompt: Optional[str] = None,
+        seed: Optional[int] = None,
+    ) -> List[bytes]:
+        """Generate some fire images from your prompt! 🎨
+
+        Args:
+            prompt (str): Your image description
+            amount (int): How many images you want (default: 1)
+            additives (bool): Make each prompt unique for variety (default: True)
+            width (int): Image width (default: 768)
+            height (int): Image height (default: 768)
+            model (str): Model to use - check AVAILABLE_MODELS (default: "flux")
+            max_retries (int): Max retry attempts if something fails (default: 3)
+            retry_delay (int): Seconds to wait between retries (default: 5)
+            negative_prompt (str, optional): What you don't want in the image
+            seed (int, optional): Seed for reproducible results
+
+        Returns:
+            List[bytes]: Your generated images as bytes
+
+        Raises:
+            ValueError: If the inputs ain't valid
+            RequestException: If the API calls fail after retries
+        """
+        # Input validation
+        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}! 🎯")
+
+        # Function to add random characters for variety
+        def add_variety():
+            return "" if not additives else "".join(choice(punctuation) for _ in range(5))
+
+        self.prompt = prompt
+        response = []
+        
+        # Build base URL with parameters
+        base_params = {
+            "width": width,
+            "height": height,
+            "model": model
+        }
+        
+        if negative_prompt:
+            base_params["negative"] = negative_prompt
+        if seed is not None:
+            base_params["seed"] = seed
+
+        for _ in range(amount):
+            current_prompt = f"{prompt}{add_variety()}"
+            params_str = "&".join(f"{k}={v}" for k, v in base_params.items())
+            url = f"{self.image_gen_endpoint.format(prompt=current_prompt)}?{params_str}"
+            
+            for attempt in range(max_retries):
+                try:
+                    logger.info(f"Generating image {_ + 1}/{amount} with prompt: {current_prompt[:50]}...")
+                    resp = self.session.get(url, timeout=self.timeout)
+                    resp.raise_for_status()
+                    response.append(resp.content)
+                    logger.success(f"Successfully generated image {_ + 1}/{amount}! 🎨")
+                    break
+                except RequestException as e:
+                    if attempt == max_retries - 1:
+                        logger.error(f"Failed to generate image after {max_retries} attempts: {e} 😢")
+                        raise
+                    logger.warning(f"Attempt {attempt + 1} failed. Retrying in {retry_delay} seconds... 🔄")
+                    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 = PollinationsAI()
+            >>> 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)
+            logger.info(f"Created directory: {save_dir} 📁")
+
+        saved_paths = []
+        timestamp = int(time.time())
+        
+        for i, image_bytes in enumerate(response):
+            if name:
+                filename = f"{filenames_prefix}{name}_{i}.{self.image_extension}"
+            else:
+                filename = f"{filenames_prefix}pollinations_{timestamp}_{i}.{self.image_extension}"
+            
+            filepath = os.path.join(save_dir, filename)
+            
+            with open(filepath, "wb") as f:
+                f.write(image_bytes)
+            
+            saved_paths.append(filepath)
+            logger.success(f"Saved image to: {filepath} 💾")
+
+        return saved_paths
+
+
+if __name__ == "__main__":
+    # Example usage
+    provider = PollinationsAI()
+    try:
+        images = provider.generate(
+            prompt="A cyberpunk city at night with neon lights",
+            amount=2,
+            width=1024,
+            height=1024,
+            model="sdxl"
+        )
+        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}")

webscout/Provider/TTI/__init__.py

@@ -1,11 +1,9 @@
 from .deepinfra import *
 from .PollinationsAI import *
-from .aiforce import *
-from .blackboximage import *
+from .AiForce import *
+from .blackbox import *
 from .Nexra import *
 from .huggingface import *
 from .artbit import *
-from .WebSimAI import *
 from .imgninza import *
-from .AIuncensoredimage import *
 from .talkai import *

webscout/Provider/TTI/artbit/__init__.py

@@ -0,0 +1,22 @@
+"""
+Artbit Providers - Your go-to solution for generating fire images! 🔥
+
+Examples:
+    >>> # Sync Usage
+    >>> from webscout import ArtbitImager
+    >>> provider = ArtbitImager(logging=True)
+    >>> images = provider.generate("Cool art")
+    >>> paths = provider.save(images)
+    >>>
+    >>> # Async Usage
+    >>> from webscout import AsyncArtbitImager
+    >>> async def example():
+    ...     provider = AsyncArtbitImager(logging=True)
+    ...     images = await provider.generate("Epic dragon")
+    ...     paths = await provider.save(images)
+"""
+
+from .sync_artbit import ArtbitImager
+from .async_artbit import AsyncArtbitImager
+
+__all__ = ["ArtbitImager", "AsyncArtbitImager"]

webscout/Provider/TTI/artbit/async_artbit.py

@@ -0,0 +1,184 @@
+"""
+AsyncArtbitImager - Your go-to async provider for generating fire images with Artbit! ⚡
+
+Examples:
+    >>> from webscout import AsyncArtbitImager
+    >>> import asyncio
+    >>> 
+    >>> async def example():
+    ...     # Initialize with logging
+    ...     provider = AsyncArtbitImager(logging=True)
+    ...     
+    ...     # Generate a single image
+    ...     images = await provider.generate("Cool art")
+    ...     paths = await provider.save(images)
+    ...     
+    ...     # Generate multiple images with parameters
+    ...     images = await provider.generate(
+    ...         prompt="Epic dragon in cyberpunk city",
+    ...         amount=3,
+    ...         caption_model="sdxl",
+    ...         selected_ratio="1024",
+    ...         negative_prompt="blurry, bad quality"
+    ...     )
+    ...     paths = await provider.save(images, name="dragon", dir="outputs")
+    >>> 
+    >>> # Run the example
+    >>> asyncio.run(example())
+"""
+
+import aiohttp
+import aiofiles
+import asyncio
+import os
+from typing import List
+from webscout.AIbase import AsyncImageProvider
+from webscout.Litlogger import LitLogger, LogFormat, ColorScheme
+from webscout.litagent import LitAgent
+
+# Initialize our fire logger and agent 🔥
+logger = LitLogger(
+    "AsyncArtbit",
+    format=LogFormat.MODERN_EMOJI,
+    color_scheme=ColorScheme.CYBERPUNK
+)
+agent = LitAgent()
+
+class AsyncArtbitImager(AsyncImageProvider):
+    """Your go-to async provider for generating fire images with Artbit! ⚡"""
+
+    def __init__(self, timeout: int = 60, proxies: dict = {}, logging: bool = True):
+        """Initialize your async Artbit 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.url = "https://artbit.ai/api/generateImage"
+        self.headers = {
+            "User-Agent": agent.random(),
+            "Content-Type": "application/json",
+            "Accept": "application/json"
+        }
+        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("AsyncArtbit provider initialized! 🚀")
+
+    async 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 asynchronously! ⚡
+
+        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] = []
+
+        if self.logging:
+            logger.info(f"Generating {amount} images with {caption_model}... 🎨")
+
+        payload = {
+            "captionInput": prompt,
+            "captionModel": caption_model,
+            "selectedRatio": selected_ratio,
+            "selectedSamples": str(amount),
+            "negative_prompt": negative_prompt
+        }
+
+        try:
+            async with aiohttp.ClientSession(headers=self.headers) as session:
+                async with session.post(self.url, json=payload, timeout=self.timeout) as resp:
+                    resp.raise_for_status()
+                    response_data = await resp.json()
+                    imgs = response_data.get("imgs", [])
+                    
+                    if imgs:
+                        response.extend(imgs)
+                        if self.logging:
+                            logger.success("Images generated successfully! 🎉")
+                    else:
+                        if self.logging:
+                            logger.warning("No images found in the response 😢")
+
+        except aiohttp.ClientError as e:
+            if self.logging:
+                logger.error(f"Failed to generate images: {e} 😢")
+            raise
+
+        return response
+
+    async def save(
+        self,
+        response: List[str],
+        name: str = None,
+        dir: str = os.getcwd(),
+        filenames_prefix: str = "",
+    ) -> List[str]:
+        """Save your fire images asynchronously! 💾
+
+        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
+
+        if self.logging:
+            logger.info(f"Saving {len(response)} images... 💾")
+
+        async with aiohttp.ClientSession(headers=self.headers) as session:
+            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:
+                    async with session.get(img_url, timeout=self.timeout) as resp:
+                        resp.raise_for_status()
+                        async with aiofiles.open(absolute_path_to_file, "wb") as fh:
+                            await fh.write(await resp.read())
+
+                except aiohttp.ClientError as e:
+                    if self.logging:
+                        logger.error(f"Failed to save image from {img_url}: {e} 😢")
+                    raise
+
+        if self.logging:
+            logger.success(f"Images saved successfully! Check {dir} 🎉")
+        return filenames

webscout/Provider/TTI/artbit/sync_artbit.py

@@ -0,0 +1,176 @@
+"""
+ArtbitImager - Your go-to provider for generating fire images with Artbit! 🔥
+
+Examples:
+    >>> from webscout import ArtbitImager
+    >>> 
+    >>> # Initialize with logging
+    >>> provider = ArtbitImager(logging=True)
+    >>> 
+    >>> # 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 List
+from webscout.AIbase import ImageProvider
+from webscout.Litlogger import LitLogger, LogFormat, ColorScheme
+from webscout.litagent import LitAgent
+
+# Initialize our fire logger and agent 🔥
+logger = LitLogger(
+    "Artbit",
+    format=LogFormat.MODERN_EMOJI,
+    color_scheme=ColorScheme.CYBERPUNK
+)
+agent = LitAgent()
+
+class ArtbitImager(ImageProvider):
+    """Your go-to provider for generating fire images with Artbit! 🔥"""
+
+    def __init__(self, timeout: int = 60, proxies: dict = {}, logging: bool = True):
+        """Initialize your Artbit 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.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"
+        self.logging = logging
+        if self.logging:
+            logger.info("Artbit provider initialized! 🚀")
+
+    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] = []
+
+        if self.logging:
+            logger.info(f"Generating {amount} images with {caption_model}... 🎨")
+
+        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)
+                if self.logging:
+                    logger.success("Images generated successfully! 🎉")
+            else:
+                if self.logging:
+                    logger.warning("No images found in the response 😢")
+
+        except requests.RequestException as e:
+            if self.logging:
+                logger.error(f"Failed to generate images: {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
+
+        if self.logging:
+            logger.info(f"Saving {len(response)} images... 💾")
+
+        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:
+                if self.logging:
+                    logger.error(f"Failed to save image from {img_url}: {e} 😢")
+                raise
+
+        if self.logging:
+            logger.success(f"Images saved successfully! Check {dir} 🎉")
+        return filenames

webscout/Provider/TTI/blackbox/__init__.py

@@ -0,0 +1,4 @@
+from .sync_blackbox import BlackboxAIImager
+from .async_blackbox import AsyncBlackboxAIImager
+
+__all__ = ["BlackboxAIImager", "AsyncBlackboxAIImager"]