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

webscout/Provider/TTI/piclumen/async_piclumen.py

@@ -1,268 +0,0 @@
-"""PiclumenImager Async Provider - Same fire, but async! ⚡
-
-Examples:
-    >>> from webscout import AsyncPiclumenImager
-    >>> import asyncio
-    >>> 
-    >>> async def main():
-    ...     provider = AsyncPiclumenImager()
-    ...     # 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 os
-import time
-import json
-from typing import List, Optional, Union, AsyncGenerator
-from datetime import datetime
-from pathlib import Path
-
-from webscout.AIbase import AsyncImageProvider
-from webscout.litagent import LitAgent
-
-# Get a fresh user agent! 🔄
-agent = LitAgent()
-
-class AsyncPiclumenImager(AsyncImageProvider):
-    """Your async homie for generating fire images using Piclumen! ⚡
-
-    This provider generates high-quality AI art with built-in retry logic
-    and error handling to make sure you get your images no cap! 💯
-
-    Examples:
-        >>> provider = AsyncPiclumenImager()
-        >>> 
-        >>> # Generate one image with default model
-        >>> async def single_image():
-        ...     image = await provider.generate("A futuristic city")
-        ...     await provider.save(image, "city.jpg")
-        >>> 
-        >>> # Generate multiple images
-        >>> async def multiple_images():
-        ...     images = await provider.generate(
-        ...         prompt="Underwater alien creatures",
-        ...         amount=3
-        ...     )
-        ...     await provider.save(images, dir="ocean_creatures")
-    """
-
-    def __init__(
-        self, 
-        timeout: int = 120, 
-        proxies: Optional[dict] = None
-    ):
-        """Initialize your AsyncPiclumenImager provider with custom settings
-
-        Examples:
-            >>> provider = AsyncPiclumenImager(timeout=180)
-            >>> provider = AsyncPiclumenImager(proxies={"http": "http://proxy:8080"})
-
-        Args:
-            timeout (int): HTTP request timeout in seconds (default: 120)
-            proxies (dict, optional): Proxy configuration for requests
-        """
-        self.api_endpoint = "https://s9.piclumen.art/comfy/api/generate-image"
-        self.headers = {
-            "Accept": "application/json",
-            "Accept-Encoding": "gzip, deflate, br, zstd",
-            "Accept-Language": "en-US,en;q=0.9,en-IN;q=0.8",
-            "Content-Type": "application/json",
-            "DNT": "1",
-            "Origin": "https://www.piclumen.com",
-            "Referer": "https://s9.piclumen.art/",
-            "Sec-Ch-Ua": '"Not(A:Brand";v="99", "Microsoft Edge";v="133", "Chromium";v="133"',
-            "Sec-Ch-Ua-Mobile": "?0",
-            "Sec-Ch-Ua-Platform": '"Windows"',
-            "Sec-Fetch-Dest": "empty",
-            "Sec-Fetch-Mode": "cors",
-            "Sec-Fetch-Site": "cross-site",
-            "Sec-Gpc": "1",
-            "User-Agent": agent.random(),  # Using our fire random agent! 🔥
-        }
-
-        self.timeout = aiohttp.ClientTimeout(total=timeout)
-        self.proxies = proxies
-        self.prompt: str = "AI-generated image - webscout"
-        self.image_extension: str = "jpg"
-
-    async def generate(
-        self,
-        prompt: str,
-        amount: int = 1,
-        max_retries: int = 3,
-        retry_delay: int = 5
-    ) -> List[bytes]:
-        """Generate some fire images from your prompt asynchronously! ⚡
-
-        Examples:
-            >>> provider = AsyncPiclumenImager()
-            >>> async def example():
-            ...     # Basic usage
-            ...     images = await provider.generate("Cool art")
-            ...     # Generate multiple
-            ...     images = await provider.generate(
-            ...         prompt="Epic underwater scene",
-            ...         amount=3
-            ...     )
-
-        Args:
-            prompt (str): Your image description
-            amount (int): How many images you want (default: 1)
-            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 as bytes
-
-        Raises:
-            ValueError: If the inputs ain't valid
-            aiohttp.ClientError: 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! 📈")
-
-        self.prompt = prompt
-        
-        # Payload with the prompt
-        payload = {
-            "prompt": prompt
-        }
-
-        async with aiohttp.ClientSession(headers=self.headers, timeout=self.timeout) as session:
-            tasks = []
-            for i in range(amount):
-                tasks.append(self._generate_single(session, payload, i, amount, max_retries, retry_delay))
-            
-            response = await asyncio.gather(*tasks)
-
-        return response
-
-    async def _generate_single(
-        self, 
-        session: aiohttp.ClientSession, 
-        payload: dict,
-        index: int,
-        total: int,
-        max_retries: int, 
-        retry_delay: int
-    ) -> bytes:
-        """Helper method to generate a single image with retries"""
-        for attempt in range(max_retries):
-            try:
-                async with session.post(self.api_endpoint, json=payload, proxy=self.proxies) as resp:
-                    resp.raise_for_status()
-                    
-                    # Check if response is an image
-                    if resp.headers.get('content-type') == 'image/jpeg':
-                        content = await resp.read()
-                        return content
-                    else:
-                        error_text = await resp.text()
-                        if attempt == max_retries - 1:
-                            raise aiohttp.ClientError(f"API returned non-image content: {error_text[:100]}")
-            
-            except aiohttp.ClientError as e:
-                if attempt == max_retries - 1:
-                    raise
-                await asyncio.sleep(retry_delay)
-
-    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 = AsyncPiclumenImager()
-            >>> 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)
-
-        saved_paths = []
-        timestamp = int(time.time())
-        
-        # Clean up name for filename use
-        safe_name = ""
-        if name:
-            safe_name = "".join(c if c.isalnum() or c in "_-" else "_" for c in name)
-            
-        # Use prompt-based name if no name is provided
-        if not safe_name and self.prompt:
-            # Clean and truncate prompt for filename
-            prompt_words = self.prompt.split()[:5]  # First 5 words
-            safe_name = "_".join("".join(c if c.isalnum() else "_" for c in word) for word in prompt_words).lower()
-        
-        async def save_single_image(image_bytes: bytes, index: int) -> str:
-            if safe_name:
-                filename = f"{filenames_prefix}{safe_name}_{index}.{self.image_extension}"
-            else:
-                filename = f"{filenames_prefix}piclumen_{timestamp}_{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__":
-    # Example usage
-    async def main():
-        provider = AsyncPiclumenImager()
-        try:
-            images = await provider.generate(
-                prompt="underwater macro photography, alien-like sea creature, translucent body, feathery appendages, glowing orbs",
-                amount=2
-            )
-            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/piclumen/sync_piclumen.py

@@ -1,233 +0,0 @@
-"""PiclumenImager Synchronous Provider - Your go-to for high-quality AI art! 🔥
-
-Examples:
-    >>> from webscout import PiclumenImager
-    >>> provider = PiclumenImager()
-    >>> 
-    >>> # 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="An underwater alien creature with bioluminescent features", 
-    ...     amount=3
-    ... )
-    >>> provider.save(images, dir="creatures")
-"""
-
-import requests
-import os
-import time
-import json
-from typing import List, Optional, Union
-from datetime import datetime
-from pathlib import Path
-from requests.exceptions import RequestException
-
-from webscout.AIbase import ImageProvider
-from webscout.litagent import LitAgent
-
-# Get a fresh user agent! 🔄
-agent = LitAgent()
-
-class PiclumenImager(ImageProvider):
-    """Your homie for generating fire images using Piclumen! 🎨
-
-    This provider generates high-quality AI art with built-in retry logic
-    and error handling to make sure you get your images no cap! 💯
-
-    Examples:
-        >>> provider = PiclumenImager()
-        >>> # Generate one image
-        >>> image = provider.generate("A futuristic city")
-        >>> provider.save(image, "city.jpg")
-        >>> 
-        >>> # Generate multiple images
-        >>> images = provider.generate(
-        ...     prompt="Underwater alien creatures",
-        ...     amount=3
-        ... )
-        >>> provider.save(images, dir="ocean_creatures")
-    """
-
-    def __init__(
-        self, 
-        timeout: int = 120, 
-        proxies: Optional[dict] = None
-    ):
-        """Initialize your PiclumenImager provider with custom settings
-
-        Examples:
-            >>> provider = PiclumenImager(timeout=180)
-            >>> provider = PiclumenImager(proxies={"http": "http://proxy:8080"})
-
-        Args:
-            timeout (int): HTTP request timeout in seconds (default: 120)
-            proxies (dict, optional): Proxy configuration for requests
-        """
-        self.api_endpoint = "https://s9.piclumen.art/comfy/api/generate-image"
-        self.headers = {
-            "Accept": "application/json",
-            "Accept-Encoding": "gzip, deflate, br, zstd",
-            "Accept-Language": "en-US,en;q=0.9,en-IN;q=0.8",
-            "Content-Type": "application/json",
-            "DNT": "1",
-            "Origin": "https://www.piclumen.com",
-            "Referer": "https://s9.piclumen.art/",
-            "Sec-Ch-Ua": '"Not(A:Brand";v="99", "Microsoft Edge";v="133", "Chromium";v="133"',
-            "Sec-Ch-Ua-Mobile": "?0",
-            "Sec-Ch-Ua-Platform": '"Windows"',
-            "Sec-Fetch-Dest": "empty",
-            "Sec-Fetch-Mode": "cors",
-            "Sec-Fetch-Site": "cross-site",
-            "Sec-Gpc": "1",
-            "User-Agent": agent.random(),  # Using our fire random agent! 🔥
-        }
-        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 = "jpg"
-
-    def generate(
-        self,
-        prompt: str,
-        amount: int = 1,
-        max_retries: int = 3,
-        retry_delay: int = 5
-    ) -> List[bytes]:
-        """Generate some fire images from your prompt! 🎨
-
-        Args:
-            prompt (str): Your image description
-            amount (int): How many images you want (default: 1)
-            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 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! 📈")
-
-        self.prompt = prompt
-        response = []
-        
-        # Payload with the prompt
-        payload = {
-            "prompt": prompt
-        }
-
-        for i in range(amount):
-            for attempt in range(max_retries):
-                try:
-                    resp = self.session.post(
-                        self.api_endpoint, 
-                        json=payload,
-                        timeout=self.timeout
-                    )
-                    resp.raise_for_status()
-                    
-                    # Check if response is an image
-                    if resp.headers.get('content-type') == 'image/jpeg':
-                        response.append(resp.content)
-                        break
-                    else:
-                        if attempt == max_retries - 1:
-                            raise RequestException(f"API returned non-image content: {resp.text[:100]}")
-                
-                except RequestException as e:
-                    if attempt == max_retries - 1:
-                        raise
-                    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 = PiclumenImager()
-            >>> 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)
-
-        saved_paths = []
-        timestamp = int(time.time())
-        
-        # Clean up name for filename use
-        safe_name = ""
-        if name:
-            safe_name = "".join(c if c.isalnum() or c in "_-" else "_" for c in name)
-            
-        # Use prompt-based name if no name is provided
-        if not safe_name and self.prompt:
-            # Clean and truncate prompt for filename
-            prompt_words = self.prompt.split()[:5]  # First 5 words
-            safe_name = "_".join("".join(c if c.isalnum() else "_" for c in word) for word in prompt_words).lower()
-        
-        for i, image_bytes in enumerate(response):
-            if safe_name:
-                filename = f"{filenames_prefix}{safe_name}_{i}.{self.image_extension}"
-            else:
-                filename = f"{filenames_prefix}piclumen_{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)
-
-        return saved_paths
-
-
-if __name__ == "__main__":
-    # Example usage
-    provider = PiclumenImager()
-    try:
-        images = provider.generate(
-            prompt="underwater macro photography, alien-like sea creature, translucent body, feathery appendages, glowing orbs, bioluminescent, ethereal, surreal",
-            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}")

webscout/Provider/TTI/pixelmuse/README.md

@@ -1,79 +0,0 @@
-# PixelMuse Image Provider 🎨
-
-A powerful image generation provider using PixelMuse's API to create stunning AI art.
-
-## Features ✨
-
-- Generate high-quality AI images from text prompts
-- Support for multiple models
-- Customizable aspect ratio and style
-- Automatic image saving with customizable filenames
-- Built-in retry mechanism for reliability
-
-## Installation 📦
-
-No additional installation required! This provider is included in the webscout package.
-
-## Usage 🚀
-
-```python
-from webscout.Provider.TTI.pixelmuse import PixelMuseImager
-
-# Create an instance of the provider
-imager = PixelMuseImager(model="flux-schnell")
-
-# Generate images
-images = imager.generate(
-    prompt="A magical forest with glowing mushrooms",
-    amount=1,
-    style="none",
-    aspect_ratio="1:1"
-)
-
-# Save the generated images
-paths = imager.save(images)
-print(f"Saved images to: {paths}")
-```
-
-## Parameters ⚙️
-
-### Initialization
-
-- `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 logging (default: True)
-
-### Generate Method
-
-- `prompt` (str): Your creative prompt
-- `amount` (int): Number of images to generate (default: 1)
-- `max_retries` (int): Maximum retry attempts (default: 3)
-- `retry_delay` (int): Seconds to wait between retries (default: 5)
-- `style` (str): Style to apply (default: "none")
-- `aspect_ratio` (str): Aspect ratio (default: "1:1")
-
-### Save Method
-
-- `response` (List[bytes]): List of image data
-- `name` (str): Base name for saved files (default: prompt)
-- `dir` (str): Directory to save images (default: current directory)
-- `filenames_prefix` (str): Prefix for filenames (default: "")
-
-## Available Models 🎯
-
-- `flux-schnell`: Fast and efficient model
-- `imagen-3-fast`: Quick Imagen 3 model
-- `imagen-3`: Full Imagen 3 model
-- `recraft-v3`: Recraft v3 model
-
-## Notes 📝
-
-- Currently only supports 1:1 aspect ratio
-- Images are saved in WebP format
-- Requires internet connection
-- Rate limits may apply based on PixelMuse's API policies
-
-## License 📄
-
-This provider is part of the webscout package. See the main package license for details.

webscout/Provider/TTI/pixelmuse/__init__.py

@@ -1,4 +0,0 @@
-from .sync_pixelmuse import PixelMuseImager
-from .async_pixelmuse import AsyncPixelMuseImager
-
-__all__ = ['PixelMuseImager', 'AsyncPixelMuseImager']