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

webscout/Provider/TTI/AiForce/async_aiforce.py

@@ -1,224 +0,0 @@
-import aiohttp
-import asyncio
-import os
-import time
-from typing import List, Optional, Union, AsyncGenerator
-from string import punctuation
-from random import choice
-from aiohttp import ClientError
-from pathlib import Path
-
-from webscout.AIbase import AsyncImageProvider
-from webscout.litagent import LitAgent
-
-agent = LitAgent()
-
-class AsyncAiForceimager(AsyncImageProvider):
-    """Your go-to async provider for generating fire images with AiForce! ⚡
-
-    Examples:
-        >>> # Basic usage
-        >>> provider = AsyncAiForceimager()
-        >>> async def example():
-        ...     images = await provider.generate("Cool art")
-        ...     paths = await provider.save(images)
-        >>>
-        >>> # Advanced usage
-        >>> provider = AsyncAiForceimager(timeout=120)
-        >>> async def example():
-        ...     images = await provider.generate(
-        ...         prompt="Epic dragon",
-        ...         amount=3,
-        ...         model="Flux-1.1-Pro",
-        ...         width=1024,
-        ...         height=1024
-        ...     )
-        ...     paths = await provider.save(images, name="dragon", dir="my_art")
-    """
-
-    AVAILABLE_MODELS = [
-        "stable-diffusion-xl-lightning",
-        "stable-diffusion-xl-base",
-        "flux",
-        "flux-realism",
-        "flux-anime",
-        "flux-3d",
-        "flux-disney",
-        "flux-pixel",
-        "flux-4o",
-        "any-dark"
-    ]
-
-    def __init__(self, timeout: int = 60, proxies: dict = {}):
-        """Initialize your async AiForce provider with custom settings! ⚙️
-
-        Args:
-            timeout (int): Request timeout in seconds (default: 60)
-            proxies (dict): Proxy settings for requests (default: {})
-        """
-        self.api_endpoint = "https://api.airforce/imagine2"
-        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 = timeout
-        self.proxies = proxies
-        self.prompt: str = "AI-generated image - webscout"
-        self.image_extension: str = "png"
-
-    async def generate(
-        self, 
-        prompt: str, 
-        amount: int = 1, 
-        additives: bool = True,
-        model: str = "flux-3d", 
-        width: int = 768, 
-        height: int = 768, 
-        seed: Optional[int] = None,
-        max_retries: int = 3, 
-        retry_delay: int = 5
-    ) -> List[bytes]:
-        """Generate some fire images from your prompt asynchronously! ⚡
-
-        Examples:
-            >>> provider = AsyncAiForceimager()
-            >>> 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 (default: True)
-            model (str): Model to use - check AVAILABLE_MODELS (default: "Flux-1.1-Pro")
-            width (int): Image width (default: 768)
-            height (int): Image height (default: 768)
-            seed (int, optional): Seed for reproducible results
-            max_retries (int): Max retry attempts if something fails (default: 3)
-            retry_delay (int): Seconds to wait between retries (default: 5)
-
-        Returns:
-            List[bytes]: Your generated images
-
-        Raises:
-            ValueError: If the inputs ain't valid
-            ClientError: If the API calls fail after retries
-        """
-        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"
-        assert model in self.AVAILABLE_MODELS, f"Model should be one of {self.AVAILABLE_MODELS}"
-
-        ads = lambda: (
-            ""
-            if not additives
-            else choice(punctuation)
-            + choice(punctuation)
-            + choice(punctuation)
-            + choice(punctuation)
-            + choice(punctuation)
-        )
-
-        self.prompt = prompt
-        response = []
-        
-        async with aiohttp.ClientSession(headers=self.headers) as session:
-            for i in range(amount):
-                url = f"{self.api_endpoint}?model={model}&prompt={prompt}&size={width}:{height}"
-                if seed:
-                    url += f"&seed={seed}"
-                
-                for attempt in range(max_retries):
-                    try:
-                        async with session.get(url, timeout=self.timeout, proxy=self.proxies.get('http')) as resp:
-                            resp.raise_for_status()
-                            response.append(await resp.read())
-                            break
-                    except ClientError as e:
-                        if attempt == max_retries - 1:
-                            raise
-                        else:
-                            await asyncio.sleep(retry_delay)
-
-        return response
-
-    async def save(
-        self,
-        response: Union[AsyncGenerator[bytes, None], List[bytes]],
-        name: Optional[str] = None,
-        dir: Optional[Union[str, Path]] = None,
-        filenames_prefix: str = "",
-    ) -> List[str]:
-        """Save your fire generated images asynchronously! 💾
-
-        Examples:
-            >>> provider = AsyncAiForceimager()
-            >>> async def example():
-            ...     images = await provider.generate("Cool art")
-            ...     # Save with default settings
-            ...     paths = await provider.save(images)
-            ...     # Save with custom name and directory
-            ...     paths = await provider.save(
-            ...         images,
-            ...         name="my_art",
-            ...         dir="my_images",
-            ...         filenames_prefix="test_"
-            ...     )
-
-        Args:
-            response (Union[AsyncGenerator[bytes, None], List[bytes]]): Your generated images
-            name (Optional[str]): Custom name for your images
-            dir (Optional[Union[str, Path]]): Where to save the images (default: current directory)
-            filenames_prefix (str): Prefix for your image files
-
-        Returns:
-            List[str]: Paths to your saved images
-        """
-        save_dir = dir if dir else os.getcwd()
-        if not os.path.exists(save_dir):
-            os.makedirs(save_dir)
-
-        name = self.prompt if name is None else name
-        saved_paths = []
-        timestamp = int(time.time())
-        
-        async def save_single_image(image_bytes: bytes, index: int) -> str:
-            filename = f"{filenames_prefix}{name}_{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__":
-    async def main():
-        bot = AsyncAiForceimager()
-        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:
-            print(f"An error occurred: {e}")
-
-    asyncio.run(main())

webscout/Provider/TTI/AiForce/sync_aiforce.py

@@ -1,245 +0,0 @@
-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
-
-
-agent = LitAgent()
-
-class AiForceimager(ImageProvider):
-    """Your go-to provider for generating fire images with AiForce! 🔥
-
-    Examples:
-        >>> # Basic usage
-        >>> provider = AiForceimager()
-        >>> images = provider.generate("Cool art")
-        >>> paths = provider.save(images)
-        >>>
-        >>> # Advanced usage
-        >>> provider = AiForceimager(timeout=120)
-        >>> images = provider.generate(
-        ...     prompt="Epic dragon",
-        ...     amount=3,
-        ...     model="Flux-1.1-Pro",
-        ...     width=1024,
-        ...     height=1024
-        ... )
-        >>> paths = provider.save(images, name="dragon", dir="my_art")
-    """
-
-    AVAILABLE_MODELS = [
-        "stable-diffusion-xl-lightning",
-        "stable-diffusion-xl-base",
-        "flux",
-        "flux-realism",
-        "flux-anime",
-        "flux-3d",
-        "flux-disney",
-        "flux-pixel",
-        "flux-4o",
-        "any-dark"
-    ]
-
-    def __init__(self, timeout: int = 60, proxies: dict = {}):
-        """Initialize your AiForce provider with custom settings! ⚙️
-
-        Args:
-            timeout (int): Request timeout in seconds (default: 60)
-            proxies (dict): Proxy settings for requests (default: {})
-        """
-        self.api_endpoint = "https://api.airforce/imagine2"
-        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)
-        self.session.proxies.update(proxies)
-        self.timeout = timeout
-        self.prompt: str = "AI-generated image - webscout"
-        self.image_extension: str = "png"
-
-
-    def generate(
-        self, 
-        prompt: str, 
-        amount: int = 1, 
-        additives: bool = True,
-        model: str = "flux-3d", 
-        width: int = 768, 
-        height: int = 768, 
-        seed: Optional[int] = None,
-        max_retries: int = 3, 
-        retry_delay: int = 5
-    ) -> List[bytes]:
-        """Generate some fire images from your prompt! 🎨
-
-        Examples:
-            >>> provider = AiForceimager()
-            >>> # Basic usage
-            >>> images = provider.generate("Cool art")
-            >>> # Advanced usage
-            >>> images = provider.generate(
-            ...     prompt="Epic dragon",
-            ...     amount=3,
-            ...     model="Flux-1.1-Pro"
-            ... )
-
-        Args:
-            prompt (str): Your image description
-            amount (int): How many images you want (default: 1)
-            additives (bool): Make each prompt unique (default: True)
-            model (str): Model to use - check AVAILABLE_MODELS (default: "Flux-1.1-Pro")
-            width (int): Image width (default: 768)
-            height (int): Image height (default: 768)
-            seed (int, optional): Seed for reproducible results
-            max_retries (int): Max retry attempts if something fails (default: 3)
-            retry_delay (int): Seconds to wait between retries (default: 5)
-
-        Returns:
-            List[bytes]: Your generated images
-
-        Raises:
-            ValueError: If the inputs ain't valid
-            RequestException: If the API calls fail after retries
-        """
-        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"
-        assert model in self.AVAILABLE_MODELS, f"Model should be one of {self.AVAILABLE_MODELS}"
-
-        ads = lambda: (
-            ""
-            if not additives
-            else choice(punctuation)
-            + choice(punctuation)
-            + choice(punctuation)
-            + choice(punctuation)
-            + choice(punctuation)
-        )
-
-        self.prompt = prompt
-        response = []
-        for _ in range(amount):
-            url = f"{self.api_endpoint}?model={model}&prompt={prompt}&size={width}:{height}"
-            if seed:
-                url += f"&seed={seed}"
-            
-            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
-                    else:
-                        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 = AiForceimager()
-            >>> images = provider.generate("Cool art")
-            >>> # Save with default settings
-            >>> paths = provider.save(images)
-            >>> # Save with custom name and directory
-            >>> paths = provider.save(
-            ...     images,
-            ...     name="my_art",
-            ...     dir="my_images",
-            ...     filenames_prefix="test_"
-            ... )
-
-        Args:
-            response (List[bytes]): Your generated images
-            name (Optional[str]): Custom name for your images
-            dir (Optional[Union[str, Path]]): Where to save the images (default: current directory)
-            filenames_prefix (str): Prefix for your image files
-
-        Returns:
-            List[str]: Paths to your saved images
-        """
-        save_dir = dir if dir else os.getcwd()
-        if not os.path.exists(save_dir):
-            os.makedirs(save_dir)
-
-        name = self.prompt if name is None else name
-        filenames = []
-        count = 0
-
-        for image in response:
-            def complete_path():
-                count_value = "" if count == 0 else f"_{count}"
-                return os.path.join(save_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)
-
-        return filenames
-
-if __name__ == "__main__":
-    bot = AiForceimager()
-    test_prompt = "A shiny red sports car speeding down a scenic mountain road"
-    
-    print(f"Testing all available models with prompt: '{test_prompt}'")
-    print("-" * 50)
-    
-    # Create a directory for test images if it doesn't exist
-    test_dir = "model_test_images"
-    if not os.path.exists(test_dir):
-        os.makedirs(test_dir)
-        
-    for model in bot.AVAILABLE_MODELS:
-        print(f"Testing model: {model}")
-        try:
-            # Generate an image with the current model
-            resp = bot.generate(
-                prompt=test_prompt,
-                amount=1,
-                model=model,
-                width=768,
-                height=768
-            )
-            
-            # Save the image with model name as prefix
-            saved_paths = bot.save(
-                resp, 
-                name=f"{model}_test", 
-                dir=test_dir, 
-                filenames_prefix=f"{model}_"
-            )
-            
-            print(f"✓ Success! Saved image: {saved_paths[0]}")
-        except Exception as e:
-            print(f"✗ Failed with model {model}: {str(e)}")
-        
-        print("-" * 30)
-    
-    print("All model tests completed!")

webscout/Provider/TTI/FreeAIPlayground/README.md

@@ -1,99 +0,0 @@
-# FreeAI Image Provider 🎨
-
-Generate amazing images with our FreeAI provider! Access to powerful models like DALL-E 3 and Flux series! 🚀
-
-## Features 💫
-- Both sync and async support ⚡
-- 7 powerful models to choose from 🎭
-- Smart retry mechanism 🔄
-- Custom image sizes 📐
-- Save with custom names 💾
-- Fire logging with cyberpunk theme 🌟
-- Proxy support for stealth mode 🕵️‍♂️
-
-## Quick Start 🚀
-
-### Installation 📦
-```bash
-pip install webscout
-```
-
-### Basic Usage 💫
-
-```python
-# Sync way
-from webscout import FreeAIImager
-
-provider = FreeAIImager()
-images = provider.generate("Epic dragon")
-paths = provider.save(images)
-
-# Async way
-from webscout import AsyncFreeAIImager
-import asyncio
-
-async def generate():
-    provider = AsyncFreeAIImager()
-    images = await provider.generate("Cool art")
-    paths = await provider.save(images)
-
-asyncio.run(generate())
-```
-
-## Available Models 🎭
-
-| Model | Description | Best For |
-|-------|-------------|----------|
-| `dall-e-3` | Latest DALL-E model (Default) | High quality general purpose |
-| `Flux Pro Ultra` | Premium Flux model | Professional quality |
-| `Flux Pro` | Standard Pro model | High quality images |
-| `Flux Pro Ultra Raw` | Unprocessed Ultra output | Raw creative control |
-| `Flux Schnell` | Fast generation model | Quick results |
-| `Flux Realism` | Photorealistic model | Realistic images |
-| `grok-2-aurora` | Aurora enhancement | Artistic flair |
-
-## Advanced Usage 🔧
-
-### Custom Settings
-```python
-provider = FreeAIImager(
-    model="Flux Pro Ultra",
-    timeout=120,
-    logging=True
-)
-
-images = provider.generate(
-    prompt="Epic dragon",
-    amount=2,
-    size="1024x1024",
-    quality="hd",
-    style="vivid"
-)
-paths = provider.save(images, dir="dragons")
-```
-
-### Async with Error Handling ⚡
-```python
-async def generate_safely():
-    provider = AsyncFreeAIImager()
-    try:
-        images = await provider.generate(
-            prompt="Epic dragon",
-            model="Flux Pro Ultra",
-            amount=2
-        )
-        paths = await provider.save(images, dir="dragons")
-        print(f"Saved to: {paths}")
-    except Exception as e:
-        print(f"Oops! Something went wrong: {e}")
-
-asyncio.run(generate_safely())
-```
-
-## Tips & Tricks 💡
-
-1. Use `Flux Realism` for photorealistic images
-2. Use `Flux Pro Ultra` for highest quality
-3. Use `Flux Schnell` for quick drafts
-4. Set custom timeouts for large generations
-5. Enable logging for detailed progress updates

webscout/Provider/TTI/FreeAIPlayground/__init__.py

@@ -1,9 +0,0 @@
-"""
-FreeAI Provider Package
-Provides access to various AI models for image generation including DALL-E 3 and Flux models
-"""
-
-from .sync_freeaiplayground import FreeAIImager
-from .async_freeaiplayground import AsyncFreeAIImager
-
-__all__ = ['FreeAIImager', 'AsyncFreeAIImager']