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

webscout/Provider/TTI/deepinfra/async_deepinfra.py

@@ -0,0 +1,227 @@
+import aiohttp
+import asyncio
+import os
+import base64
+from typing import List, Union, AsyncGenerator
+from string import punctuation
+from random import choice
+from random import randint
+import aiofiles
+
+from webscout.AIbase import AsyncImageProvider
+from webscout.litagent import LitAgent  # Import our fire user agent generator 🔥
+from webscout.Litlogger import LitLogger  # For that cyberpunk logging swag ⚡
+
+# Initialize our fire logger 🚀
+logger = LitLogger("AsyncDeepInfraImager")
+
+class AsyncDeepInfraImager(AsyncImageProvider):
+    """
+    Async DeepInfra Image Provider - Your go-to for fire AI art! 🎨
+    
+    >>> # Generate some fire art asynchronously! 🔥
+    >>> async def generate_art():
+    ...     imager = AsyncDeepInfraImager(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 = AsyncDeepInfraImager(logging=False)
+    ...     images = await quiet_imager.generate("Cyberpunk city at night")
+    ...     paths = await quiet_imager.save(images)
+    >>> asyncio.run(stealth_art())
+    """
+
+    def __init__(
+        self,
+        model: str = "black-forest-labs/FLUX-1-schnell",
+        timeout: int = 60,
+        proxies: dict = {},
+        logging: bool = True
+    ):
+        """Initialize your async DeepInfra provider with custom settings! ⚙️
+
+        Args:
+            model (str): Which model to use (default: black-forest-labs/FLUX-1-schnell)
+            timeout (int): Request timeout in seconds (default: 60)
+            proxies (dict): Proxy settings for requests (default: {})
+            logging (bool): Enable fire logging (default: True)
+        """
+        self.image_gen_endpoint: str = f"https://api.deepinfra.com/v1/inference/{model}"
+        self.headers = {
+            "Accept": "application/json, text/plain, */*",
+            "Accept-Language": "en-US,en;q=0.9,en-IN;q=0.8",
+            "Accept-Encoding": "gzip, deflate, br, zstd",
+            "User-Agent": LitAgent().random(),  # Using our fire random agent! 🔥
+            "DNT": "1",
+            "Origin": "https://deepinfra.com",
+            "Referer": "https://deepinfra.com/",
+            "Sec-CH-UA": '"Chromium";v="128", "Not;A=Brand";v="24", "Microsoft Edge";v="128"',
+            "Sec-CH-UA-Mobile": "?0",
+            "Sec-CH-UA-Platform": '"Windows"',
+            "Sec-Fetch-Dest": "empty",
+            "Sec-Fetch-Mode": "cors",
+            "Sec-Fetch-Site": "same-site"
+        }
+        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("AsyncDeepInfraImager initialized! Ready to create some fire art! 🚀")
+
+    async def generate(
+        self, prompt: str, amount: int = 1, additives: bool = True,
+        num_inference_steps: int = 25, guidance_scale: float = 7.5,
+        width: int = 1024, height: int = 1024, seed: int = None,
+        max_retries: int = 3, retry_delay: int = 5
+    ) -> List[bytes]:
+        """Generate some fire images from your prompt! 🎨
+
+        Args:
+            prompt (str): Your creative prompt
+            amount (int): How many images to generate
+            additives (bool): Add random characters to make prompts unique
+            num_inference_steps (int): Number of inference steps
+            guidance_scale (float): Guidance scale for generation
+            width (int): Image width
+            height (int): Image height
+            seed (int, optional): Random seed for reproducibility
+            max_retries (int): Max retry attempts if generation fails
+            retry_delay (int): Seconds to wait between retries
+
+        Returns:
+            List[bytes]: Your generated images as bytes
+        """
+        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"
+
+        ads = lambda: (
+            ""
+            if not additives
+            else choice(punctuation)
+            + choice(punctuation)
+            + choice(punctuation)
+            + choice(punctuation)
+            + choice(punctuation)
+        )
+
+        self.prompt = prompt
+        response = []
+
+        if self.logging:
+            logger.info(f"Generating {amount} images... 🎨")
+
+        async with aiohttp.ClientSession(headers=self.headers) as session:
+            for _ in range(amount):
+                payload = {
+                    "prompt": prompt + ads(),
+                    "num_inference_steps": num_inference_steps,
+                    "guidance_scale": guidance_scale,
+                    "width": width,
+                    "height": height,
+                    "seed": seed if seed is not None else randint(1, 10000),
+                }
+
+                for attempt in range(max_retries):
+                    try:
+                        async with session.post(
+                            self.image_gen_endpoint,
+                            json=payload,
+                            timeout=self.timeout,
+                            proxy=self.proxies.get('http') if self.proxies else None
+                        ) as resp:
+                            resp.raise_for_status()
+                            data = await resp.json()
+                            # Extract base64 encoded image data and decode it
+                            image_data = data['images'][0].split(",")[1]
+                            image_bytes = base64.b64decode(image_data)
+                            response.append(image_bytes)
+                            if self.logging:
+                                logger.success(f"Generated image {len(response)}/{amount}! 🎨")
+                            break
+                    except aiohttp.ClientError as e:
+                        if attempt == max_retries - 1:
+                            if self.logging:
+                                logger.error(f"Failed to generate image after {max_retries} attempts: {e} 😢")
+                            raise
+                        else:
+                            if self.logging:
+                                logger.warning(f"Attempt {attempt + 1} failed. Retrying in {retry_delay} seconds... 🔄")
+                            await asyncio.sleep(retry_delay)
+
+        if self.logging:
+            logger.success("All images generated successfully! 🎉")
+        return response
+
+    async def save(
+        self,
+        response: Union[List[bytes], AsyncGenerator[bytes, None]],
+        name: str = None,
+        dir: str = os.getcwd(),
+        filenames_prefix: str = "",
+    ) -> List[str]:
+        """Save your fire images! 💾
+
+        Args:
+            response (Union[List[bytes], AsyncGenerator[bytes, None]]): 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
+        """
+        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(image_bytes: bytes, index: int) -> str:
+            filename = f"{filenames_prefix}{name}_{index}.{self.image_extension}"
+            filepath = os.path.join(dir, filename)
+            
+            async with aiofiles.open(filepath, "wb") as f:
+                await f.write(image_bytes)
+            
+            if self.logging:
+                logger.success(f"Saved image to: {filepath} 💾")
+            return filename
+
+        if isinstance(response, list):
+            image_list = response
+        else:
+            image_list = [chunk async for chunk in response]
+
+        if self.logging:
+            logger.info(f"Saving {len(image_list)} images... 💾")
+
+        tasks = [save_single_image(img, i) for i, img in enumerate(image_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 = AsyncDeepInfraImager()
+        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())

webscout/Provider/TTI/deepinfra/sync_deepinfra.py

@@ -0,0 +1,199 @@
+import requests
+import os
+from typing import List
+from string import punctuation
+from random import choice
+from random import randint
+import base64
+
+from webscout.AIbase import ImageProvider
+from webscout.litagent import LitAgent  # Import our fire user agent generator 🔥
+from webscout.Litlogger import LitLogger  # For that cyberpunk logging swag ⚡
+
+# Initialize our fire logger 🚀
+logger = LitLogger("DeepInfraImager")
+
+class DeepInfraImager(ImageProvider):
+    """
+    DeepInfra Image Provider - Your go-to for fire AI art! 🎨
+    
+    >>> # Generate some fire art! 🔥
+    >>> imager = DeepInfraImager(logging=True)
+    >>> images = imager.generate("Epic dragon breathing fire", amount=2)
+    >>> paths = imager.save(images)
+    >>> print(paths)
+    ['epic_dragon_0.png', 'epic_dragon_1.png']
+    
+    >>> # Turn off logging for stealth mode 🥷
+    >>> quiet_imager = DeepInfraImager(logging=False)
+    >>> images = quiet_imager.generate("Cyberpunk city at night")
+    >>> paths = quiet_imager.save(images)
+    """
+
+    def __init__(
+        self,
+        model: str = "black-forest-labs/FLUX-1-schnell",
+        timeout: int = 60,
+        proxies: dict = {},
+        logging: bool = True
+    ):
+        """Initialize your DeepInfra provider with custom settings! ⚙️
+
+        Args:
+            model (str): Which model to use (default: black-forest-labs/FLUX-1-schnell)
+            timeout (int): Request timeout in seconds (default: 60)
+            proxies (dict): Proxy settings for requests (default: {})
+            logging (bool): Enable fire logging (default: True)
+        """
+        self.image_gen_endpoint: str = f"https://api.deepinfra.com/v1/inference/{model}"
+        self.headers = {
+            "Accept": "application/json, text/plain, */*",
+            "Accept-Language": "en-US,en;q=0.9,en-IN;q=0.8",
+            "Accept-Encoding": "gzip, deflate, br, zstd",
+            "User-Agent": LitAgent().random(),  # Using our fire random agent! 🔥
+            "DNT": "1",
+            "Origin": "https://deepinfra.com",
+            "Referer": "https://deepinfra.com/",
+            "Sec-CH-UA": '"Chromium";v="128", "Not;A=Brand";v="24", "Microsoft Edge";v="128"',
+            "Sec-CH-UA-Mobile": "?0",
+            "Sec-CH-UA-Platform": '"Windows"',
+            "Sec-Fetch-Dest": "empty",
+            "Sec-Fetch-Mode": "cors",
+            "Sec-Fetch-Site": "same-site"
+        }
+        self.session = requests.Session()
+        self.session.headers.update(self.headers)
+        self.session.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("DeepInfraImager initialized! Ready to create some fire art! 🚀")
+
+    def generate(
+        self, prompt: str, amount: int = 1, additives: bool = True, 
+        num_inference_steps: int = 25, guidance_scale: float = 7.5, 
+        width: int = 1024, height: int = 1024, seed: int = None
+    ) -> List[bytes]:
+        """Generate some fire images from your prompt! 🎨
+
+        Args:
+            prompt (str): Your creative prompt
+            amount (int): How many images to generate
+            additives (bool): Add random characters to make prompts unique
+            num_inference_steps (int): Number of inference steps
+            guidance_scale (float): Guidance scale for generation
+            width (int): Image width
+            height (int): Image height
+            seed (int, optional): Random seed for reproducibility
+
+        Returns:
+            List[bytes]: Your generated images as bytes
+        """
+        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"
+
+        ads = lambda: (
+            ""
+            if not additives
+            else choice(punctuation)
+            + choice(punctuation)
+            + choice(punctuation)
+            + choice(punctuation)
+            + choice(punctuation)
+        )
+
+        if self.logging:
+            logger.info(f"Generating {amount} images... 🎨")
+
+        self.prompt = prompt
+        response = []
+        for _ in range(amount):
+            payload = {
+                "prompt": prompt + ads(),
+                "num_inference_steps": num_inference_steps,
+                "guidance_scale": guidance_scale,
+                "width": width,
+                "height": height,
+                "seed": seed if seed is not None else randint(1, 10000), 
+            }
+            try:
+                resp = self.session.post(url=self.image_gen_endpoint, json=payload, timeout=self.timeout)
+                resp.raise_for_status()
+                # Extract base64 encoded image data and decode it
+                image_data = resp.json()['images'][0].split(",")[1]
+                image_bytes = base64.b64decode(image_data)
+                response.append(image_bytes)
+                if self.logging:
+                    logger.success(f"Generated image {len(response)}/{amount}! 🎨")
+            except Exception as e:
+                if self.logging:
+                    logger.error(f"Failed to generate image: {e} 😢")
+                raise
+
+        if self.logging:
+            logger.success("All images generated successfully! 🎉")
+        return response
+
+    def save(
+        self,
+        response: List[bytes],
+        name: str = None,
+        dir: str = os.getcwd(),
+        filenames_prefix: str = "",
+    ) -> List[str]:
+        """Save your fire 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)
+            if self.logging:
+                logger.info(f"Created directory: {dir} 📁")
+
+        if self.logging:
+            logger.info(f"Saving {len(response)} images... 💾")
+
+        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)
+            if self.logging:
+                logger.success(f"Saved image to: {absolute_path_to_file} 💾")
+
+        if self.logging:
+            logger.success(f"All images saved successfully! Check {dir} 🎉")
+        return filenames
+
+
+if __name__ == "__main__":
+    bot = DeepInfraImager()
+    try:
+        resp = bot.generate("A shiny red sports car speeding down a scenic mountain road", 1)
+        print(bot.save(resp))
+    except Exception as e:
+        if bot.logging:
+            logger.error(f"An error occurred: {e} 😢")

webscout/Provider/TTI/huggingface/__init__.py

@@ -0,0 +1,22 @@
+"""
+HuggingFace Providers - Your go-to solution for generating fire images! 🔥
+
+Examples:
+    >>> # Sync Usage
+    >>> from webscout import HFimager
+    >>> provider = HFimager(api_token="your-hf-token")
+    >>> images = provider.generate("Cool art")
+    >>> paths = provider.save(images)
+    >>>
+    >>> # Async Usage
+    >>> from webscout import AsyncHFimager
+    >>> async def example():
+    ...     provider = AsyncHFimager(api_token="your-hf-token")
+    ...     images = await provider.generate("Epic dragon")
+    ...     paths = await provider.save(images)
+"""
+
+from .sync_huggingface import HFimager
+from .async_huggingface import AsyncHFimager
+
+__all__ = ["HFimager", "AsyncHFimager"]

webscout/Provider/TTI/huggingface/async_huggingface.py

@@ -0,0 +1,199 @@
+"""
+AsyncHFimager - Your go-to async provider for generating fire images with HuggingFace! ⚡
+
+Examples:
+    >>> from webscout import AsyncHFimager
+    >>> import asyncio
+    >>> 
+    >>> async def example():
+    ...     # Initialize with your API key
+    ...     provider = AsyncHFimager(api_token="your-hf-token")
+    ...     
+    ...     # Generate a single image
+    ...     images = await provider.generate("A shiny red sports car")
+    ...     paths = await provider.save(images)
+    ...     
+    ...     # Generate multiple images with parameters
+    ...     images = await provider.generate(
+    ...         prompt="Epic dragon in cyberpunk city",
+    ...         amount=3,
+    ...         model="runwayml/stable-diffusion-v1-5",
+    ...         guidance_scale=7.5,
+    ...         negative_prompt="blurry, bad quality",
+    ...         num_inference_steps=50,
+    ...         width=768,
+    ...         height=768
+    ...     )
+    ...     paths = await provider.save(images, name="dragon", dir="outputs")
+    >>> 
+    >>> # Run the example
+    >>> asyncio.run(example())
+"""
+
+import os
+import aiohttp
+import aiofiles
+import asyncio
+from typing import Any, List, Optional, Dict
+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(
+    "AsyncHuggingFace",
+    format=LogFormat.MODERN_EMOJI,
+    color_scheme=ColorScheme.CYBERPUNK
+)
+agent = LitAgent()
+
+class AsyncHFimager(AsyncImageProvider):
+    """Your go-to async provider for generating fire images with HuggingFace! ⚡"""
+
+    def __init__(
+        self,
+        api_token: str = None,
+        timeout: int = 60,
+        proxies: dict = {},
+        logging: bool = True
+    ):
+        """Initialize your async HuggingFace provider with custom settings! ⚙️
+
+        Args:
+            api_token (str, optional): HuggingFace API token. Uses env var "HUGGINGFACE_API_TOKEN" if None
+            timeout (int): Request timeout in seconds (default: 60)
+            proxies (dict): Proxy settings for requests (default: {})
+            logging (bool): Enable fire logging (default: True)
+        """
+        self.base_url = "https://api-inference.huggingface.co/models/"
+        self.api_token = api_token or os.environ["HUGGINGFACE_API_TOKEN"]
+        self.headers = {
+            "Authorization": f"Bearer {self.api_token}",
+            "User-Agent": agent.random(),
+            "Accept": "application/json"
+        }
+        self.timeout = timeout
+        self.proxies = proxies
+        self.prompt: str = "AI-generated image - webscout"
+        self.image_extension: str = "jpg"
+        self.logging = logging
+        if self.logging:
+            logger.info("AsyncHuggingFace provider initialized! 🚀")
+
+    async def generate(
+        self,
+        prompt: str,
+        amount: int = 1,
+        model: str = "stabilityai/stable-diffusion-xl-base-1.0",
+        guidance_scale: Optional[float] = None,
+        negative_prompt: Optional[str] = None,
+        num_inference_steps: Optional[int] = None,
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+        scheduler: Optional[str] = None,
+        seed: Optional[int] = None,
+    ) -> List[bytes]:
+        """Generate some fire images asynchronously! ⚡
+
+        Args:
+            prompt (str): Your lit image description
+            amount (int): How many images to generate (default: 1)
+            model (str): Which model to use (default: "stabilityai/stable-diffusion-xl-base-1.0")
+            guidance_scale (float, optional): Control how much to follow your prompt
+            negative_prompt (str, optional): What you don't want in the image
+            num_inference_steps (int, optional): More steps = better quality but slower
+            width (int, optional): Image width
+            height (int, optional): Image height
+            scheduler (str, optional): Which scheduler to use
+            seed (int, optional): Random seed for reproducibility
+
+        Returns:
+            List[bytes]: Your generated images as bytes
+        """
+        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 = []
+        if self.logging:
+            logger.info(f"Generating {amount} images with {model}... 🎨")
+
+        async with aiohttp.ClientSession(headers=self.headers) as session:
+            for _ in range(amount):
+                url = self.base_url + model
+                payload: Dict[str, Any] = {"inputs": prompt}
+                parameters = {}
+
+                if guidance_scale is not None:
+                    parameters["guidance_scale"] = guidance_scale
+                if negative_prompt is not None:
+                    parameters["negative_prompt"] = negative_prompt
+                if num_inference_steps is not None:
+                    parameters["num_inference_steps"] = num_inference_steps
+                if width is not None and height is not None:
+                    parameters["target_size"] = {"width": width, "height": height}
+                if scheduler is not None:
+                    parameters["scheduler"] = scheduler
+                if seed is not None:
+                    parameters["seed"] = seed
+
+                if parameters:
+                    payload["parameters"] = parameters
+
+                try:
+                    async with session.post(url, json=payload, timeout=self.timeout) as resp:
+                        resp.raise_for_status()
+                        response.append(await resp.read())
+                        if self.logging:
+                            logger.success("Image generated successfully! 🎉")
+                except aiohttp.ClientError as e:
+                    if self.logging:
+                        logger.error(f"Failed to generate image: {e} 😢")
+                    raise
+
+        return response
+
+    async def save(
+        self,
+        response: List[bytes],
+        name: str = None,
+        dir: str = os.getcwd(),
+        filenames_prefix: str = "",
+    ) -> List[str]:
+        """Save your fire images asynchronously! 💾
+
+        Args:
+            response (List[bytes]): Your generated images
+            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 image_bytes 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])
+
+            async with aiofiles.open(absolute_path_to_file, "wb") as fh:
+                await fh.write(image_bytes)
+
+        if self.logging:
+            logger.success(f"Images saved successfully! Check {dir} 🎉")
+        return filenames