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

webscout/Provider/TTI/PollinationsAI/async_pollinations.py

@@ -1,311 +0,0 @@
-"""PollinationsAI Async Provider - Same fire, but async! ⚡
-
-Examples:
-    >>> from webscout import AsyncPollinationsAI
-    >>> import asyncio
-    >>> 
-    >>> async def main():
-    ...     provider = AsyncPollinationsAI()
-    ...     # 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
-from typing import List, Optional, Union
-from string import punctuation
-from random import choice
-from pathlib import Path
-from typing import AsyncGenerator
-
-from webscout.AIbase import AsyncImageProvider
-from webscout.litagent import LitAgent
-
-# Get a fresh user agent! 🔄
-agent = LitAgent()
-
-class AsyncPollinationsAI(AsyncImageProvider):
-    """Your async 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 = AsyncPollinationsAI()
-        >>> 
-        >>> # 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 with specific model
-        >>> async def multiple_images():
-        ...     images = await provider.generate(
-        ...         prompt="Space station",
-        ...         amount=3,
-        ...         width=1024,
-        ...         height=1024,
-        ...         model="flux-3d"  # For 3D-style images
-        ...     )
-        ...     await provider.save(images, dir="space_pics")
-        >>>
-        >>> # Try different models
-        >>> async def try_models():
-        ...     # Anime style
-        ...     anime = await provider.generate(
-        ...         prompt="Anime character",
-        ...         model="flux-anime"
-        ...     )
-        ...     # Realistic style
-        ...     real = await provider.generate(
-        ...         prompt="Portrait photo",
-        ...         model="flux-realism"
-        ...     )
-        ...     # Fast generation
-        ...     quick = await provider.generate(
-        ...         prompt="Quick sketch",
-        ...         model="turbo"
-        ...     )
-
-    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
-
-    """
-
-    AVAILABLE_MODELS = [
-        "flux",
-        "turbo"
-    ]
-
-    def __init__(
-        self, 
-        timeout: int = 60, 
-        proxies: Optional[dict] = None
-    ):
-        """Initialize your AsyncPollinationsAI provider with custom settings
-
-        Examples:
-            >>> provider = AsyncPollinationsAI(timeout=30)
-            >>> provider = AsyncPollinationsAI(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.timeout = aiohttp.ClientTimeout(total=timeout)
-        self.proxies = proxies
-        self.prompt: str = "AI-generated image - webscout"
-        self.image_extension: str = "jpeg"
-
-    async def generate(
-        self,
-        prompt: str,
-        amount: int = 1,
-        additives: bool = True,
-        width: int = 768,
-        height: int = 768,
-        model: str = "flux",
-        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 asynchronously! ⚡
-
-        Examples:
-            >>> provider = AsyncPollinationsAI()
-            >>> async def example():
-            ...     # Basic usage
-            ...     images = await provider.generate("Cool art")
-            ...     # Advanced usage
-            ...     images = await provider.generate(
-            ...         prompt="Epic dragon",
-            ...         amount=3,
-            ...         model="flux-3d"
-            ...     )
-
-        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
-            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! 📈")
-        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
-
-        async with aiohttp.ClientSession(headers=self.headers, timeout=self.timeout) as session:
-            tasks = []
-            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}"
-                
-                tasks.append(self._generate_single(session, url, max_retries, retry_delay))
-            
-            response = await asyncio.gather(*tasks)
-
-
-        return response
-
-    async def _generate_single(
-        self, 
-        session: aiohttp.ClientSession, 
-        url: str, 
-        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.get(url, proxy=self.proxies) as resp:
-                    resp.raise_for_status()
-                    return await resp.read()
-            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 = AsyncPollinationsAI()
-            >>> 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())
-        
-        async def save_single_image(image_bytes: bytes, index: int) -> str:
-            if name:
-                filename = f"{filenames_prefix}{name}_{index}.{self.image_extension}"
-            else:
-                filename = f"{filenames_prefix}pollinations_{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 = AsyncPollinationsAI()
-        try:
-            images = await provider.generate(
-                prompt="A cyberpunk city at night with neon lights",
-                amount=2,
-                width=1024,
-                height=1024,
-                model="sdxl"
-            )
-            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/PollinationsAI/sync_pollinations.py

@@ -1,265 +0,0 @@
-"""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.litagent import LitAgent
-
-
-# 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
-    """
-
-    AVAILABLE_MODELS = [
-        "flux",
-        "turbo"
-    ]
-
-
-    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 = "flux",
-        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:
-                    resp = self.session.get(url, timeout=self.timeout)
-                    resp.raise_for_status()
-                    response.append(resp.content)
-                    break
-                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 = 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)
-
-        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)
-
-        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/aiarta/README.md

@@ -1,134 +0,0 @@
-# AIArta Image Generator
-
-Generate stunning AI art with AI Arta! 🎨 This package provides both synchronous and asynchronous interfaces to the AIArta image generation service.
-
-## Features
-
-- Generate high-quality images from text prompts
-- 45+ artistic styles and models to choose from
-- Customize image generation with various parameters
-- Save images with automatic naming and organization
-- Both synchronous and asynchronous implementations
-
-## Installation
-
-```bash
-pip install webscout
-```
-
-## Usage
-
-### Synchronous Usage
-
-```python
-from webscout import AIArtaImager
-
-# Initialize the provider
-provider = AIArtaImager()
-
-# 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"
-)
-provider.save(images, dir="dragon_pics")
-```
-
-### Asynchronous Usage
-
-```python
-from webscout import AsyncAIArtaImager
-import asyncio
-
-async def generate_images():
-    # Initialize with logging
-    provider = AsyncAIArtaImager(logging=True)
-    
-    # Generate a single image
-    images = await provider.generate("A beautiful sunset over mountains")
-    paths = await provider.save(images)
-    
-    # Generate multiple images with parameters
-    images = await provider.generate(
-        prompt="Epic dragon in cyberpunk city",
-        amount=2,
-        model="fantasy_art",
-        negative_prompt="ugly, deformed",
-        guidance_scale=7,
-        num_inference_steps=30
-    )
-    paths = await provider.save(images, name="dragon", dir="outputs")
-
-# Run the async function
-asyncio.run(generate_images())
-```
-
-## Available Models
-
-The AIArta provider supports 45+ models, including:
-
-- `flux` - General purpose model
-- `fantasy_art` - Fantasy-style images
-- `photographic` - Realistic photographic style
-- `watercolor` - Watercolor painting style
-- `low_poly` - Low-poly art style
-- `anime_tattoo` - Anime-inspired tattoo designs
-- `cinematic_art` - Movie-like cinematic images
-
-See the full list in the `model_aliases` variable in the code.
-
-## Parameters
-
-| Parameter | Type | Default | Description |
-|-----------|------|---------|-------------|
-| prompt | str | | Your image description |
-| amount | int | 1 | Number of images to generate |
-| model | str | "Flux" | Model to use for generation |
-| negative_prompt | str | "blurry, deformed hands, ugly" | What to avoid in the image |
-| guidance_scale | int | 7 | How closely to follow the prompt |
-| num_inference_steps | int | 30 | More steps = better quality but slower |
-| aspect_ratio | str | "1:1" | Image aspect ratio |
-
-## Advanced Usage
-
-### Custom Timeouts and Proxies
-
-```python
-# Synchronous with custom settings
-provider = AIArtaImager(
-    timeout=120,
-    proxies={"http": "http://proxy:8080"},
-    logging=True
-)
-
-# Asynchronous with custom settings
-async_provider = AsyncAIArtaImager(
-    timeout=120,
-    proxies={"http": "http://proxy:8080"},
-    logging=True
-)
-```
-
-### Saving Images with Custom Naming
-
-```python
-# Generate images
-images = provider.generate("Beautiful landscape")
-
-# Save with custom name and directory
-provider.save(
-    images,
-    name="landscape",
-    dir="my_art_folder",
-    filenames_prefix="vacation_"
-)
-```
-
-## Authentication
-
-The provider handles authentication automatically, storing and refreshing tokens as needed. No manual setup required!