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

webscout/Provider/TTI/FreeAIPlayground/async_freeaiplayground.py

@@ -1,181 +0,0 @@
-import aiohttp
-import asyncio
-import os
-from typing import List, Union, AsyncGenerator
-from string import punctuation
-from random import choice
-import aiofiles
-
-from webscout.AIbase import AsyncImageProvider
-from webscout.litagent import LitAgent
-
-class AsyncFreeAIImager(AsyncImageProvider):
-    """
-    Async FreeAI Image Provider - Your go-to for fire AI art! 🎨
-    """
-    
-    AVAILABLE_MODELS = [
-        "dall-e-3",
-        "Flux Pro Ultra",
-        "Flux Pro",
-        "Flux Pro Ultra Raw",
-        "Flux Schnell",
-        "Flux Realism",
-        "grok-2-aurora",
-        "Flux Dev",
-
-    ]
-
-    def __init__(
-        self,
-        model: str = "dall-e-3",
-        timeout: int = 60,
-        proxies: dict = {}
-    ):
-        """Initialize your async FreeAIPlayground provider with custom settings! ⚙️
-
-        Args:
-            model (str): Which model to use (default: dall-e-3)
-            timeout (int): Request timeout in seconds (default: 60)
-            proxies (dict): Proxy settings for requests (default: {})
-        """
-        self.image_gen_endpoint: str = "https://api.freeaichatplayground.com/v1/images/generations"
-        self.headers = {
-            "Accept": "application/json",
-            "Accept-Language": "en-US,en;q=0.9",
-            "Content-Type": "application/json",
-            "User-Agent": LitAgent().random(),
-            "Origin": "https://freeaichatplayground.com",
-            "Referer": "https://freeaichatplayground.com/",
-        }
-        self.timeout = aiohttp.ClientTimeout(total=timeout)
-        self.model = model
-        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,
-        size: str = "1024x1024", quality: str = "standard",
-        style: str = "vivid", 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
-            size (str): Image size (1024x1024, 1024x1792, 1792x1024)
-            quality (str): Image quality (standard, hd)
-            style (str): Image style (vivid, natural)
-            max_retries (int): Max retry attempts if generation fails
-            retry_delay (int): Delay between retries in seconds
-
-        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)
-        )
-
-        self.prompt = prompt
-        response = []
-        
-        async with aiohttp.ClientSession(headers=self.headers, timeout=self.timeout) as session:
-            for i in range(amount):
-                payload = {
-                    "model": self.model,
-                    "prompt": prompt + ads(),
-                    "n": 1,
-                    "size": size,
-                    "quality": quality,
-                    "style": style
-                }
-                
-                for attempt in range(max_retries):
-                    try:
-                        async with session.post(self.image_gen_endpoint, json=payload) as resp:
-                            resp.raise_for_status()
-                            data = await resp.json()
-                            if 'data' in data and len(data['data']) > 0:
-                                image_url = data['data'][0]['url']
-                                
-                                async with session.get(image_url) as img_resp:
-                                    img_resp.raise_for_status()
-                                    image_bytes = await img_resp.read()
-                                    response.append(image_bytes)
-                                break
-                            else:
-                                print(f"Warning: No image data in response: {data}")
-                                if attempt == max_retries - 1:
-                                    raise Exception("No image data received after all retries")
-                    except Exception as e:
-                        print(f"Error generating image (attempt {attempt + 1}/{max_retries}): {str(e)}")
-                        if attempt == max_retries - 1:
-                            raise
-                        await asyncio.sleep(retry_delay)
-
-        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)
-
-        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)
-            return filename
-
-        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 = AsyncFreeAIImager()
-        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:
-            pass
-
-    asyncio.run(main())

webscout/Provider/TTI/FreeAIPlayground/sync_freeaiplayground.py

@@ -1,180 +0,0 @@
-import requests
-import os
-from typing import Union, 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 🔥
-
-class FreeAIImager(ImageProvider):
-    """
-    FreeAI Image Provider - Your go-to for fire AI art! 🎨
-    """
-    
-    AVAILABLE_MODELS = [
-        "dall-e-3",
-        "Flux Pro Ultra",
-        "Flux Pro",
-        "Flux Pro Ultra Raw",
-        "Flux Schnell",
-        "Flux Realism",
-        "grok-2-aurora",
-        "Flux Dev",
-    ]
-
-    def __init__(
-        self,
-        model: str = "dall-e-3",  # Updated default model
-        timeout: int = 60,
-        proxies: dict = {},
-    ):
-        """Initialize your FreeAIPlayground provider with custom settings! ⚙️
-
-        Args:
-            model (str): Which model to use (default: dall-e-3)
-            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 = "https://api.freeaichatplayground.com/v1/images/generations"
-        self.headers = {
-            "Accept": "application/json",
-            "Accept-Language": "en-US,en;q=0.9",
-            "Content-Type": "application/json",
-            "User-Agent": LitAgent().random(), 
-            "Origin": "https://freeaichatplayground.com",
-            "Referer": "https://freeaichatplayground.com/",
-        }
-        self.session = requests.Session()
-        self.session.headers.update(self.headers)
-        self.session.proxies.update(proxies)
-        self.timeout = timeout
-        self.model = model
-        self.prompt: str = "AI-generated image - webscout"
-        self.image_extension: str = "png"
-
-    def generate(
-        self, prompt: str, amount: int = 1, additives: bool = True,
-        size: str = "1024x1024", quality: str = "standard",
-        style: str = "vivid", 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
-            size (str): Image size (1024x1024, 1024x1792, 1792x1024)
-            quality (str): Image quality (standard, hd)
-            style (str): Image style (vivid, natural)
-            max_retries (int): Max retry attempts if generation fails
-            retry_delay (int): Delay between retries in seconds
-
-        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)
-        )
-
-        self.prompt = prompt
-        response = []
-        for _ in range(amount):
-            payload = {
-                "model": self.model,
-                "prompt": prompt + ads(),
-                "n": 1,
-                "size": size,
-                "quality": quality,
-                "style": style
-            }
-            
-            for attempt in range(max_retries):
-                try:
-                    resp = self.session.post(
-                        url=self.image_gen_endpoint,
-                        json=payload,
-                        timeout=self.timeout
-                    )
-                    resp.raise_for_status()
-                    response_data = resp.json()
-                    if 'data' in response_data and len(response_data['data']) > 0:
-                        image_url = response_data['data'][0]['url']
-                        # Get the image data from the URL
-                        img_resp = self.session.get(image_url, timeout=self.timeout)
-                        img_resp.raise_for_status()
-                        response.append(img_resp.content)
-                        break
-                    else:
-                        print(f"Warning: No image data in response: {response_data}")
-                        if attempt == max_retries - 1:
-                            raise Exception("No image data received after all retries")
-                except Exception as e:
-                    print(f"Error generating image (attempt {attempt + 1}/{max_retries}): {str(e)}")
-                    if attempt == max_retries - 1:
-                        raise
-                    import time
-                    time.sleep(retry_delay)
-        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)
-
-        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)
-        return filenames
-
-
-if __name__ == "__main__":
-    bot = FreeAIImager()
-    try:
-        resp = bot.generate("A shiny red sports car speeding down a scenic mountain road", 1)
-        print(bot.save(resp))
-    except Exception:
-        pass
-

webscout/Provider/TTI/ImgSys/README.md

@@ -1,174 +0,0 @@
-# ImgSys Provider 🎨
-
-A powerful text-to-image generation provider that uses multiple AI models to create unique images from your prompts! 
-
-## Features ✨
-
-- Generate 2 unique images from random providers for each prompt
-- Support for both synchronous and asynchronous operations
-- Built-in retry logic with configurable attempts and delays
-- Comprehensive error handling and input validation
-- Easy image saving with custom names and directories
-- Random user agent rotation for requests
-- Proxy support for enhanced privacy
-- Detailed documentation and examples
-
-## Installation 🚀
-
-The ImgSys provider is part of the Webscout package. You can install it using pip:
-
-```bash
-pip install webscout
-```
-
-## Usage Examples 📝
-
-### Synchronous Usage
-
-```python
-from webscout import ImgSys
-
-# Initialize the provider
-provider = ImgSys()
-
-# Generate images
-images = provider.generate("A cool cyberpunk city at night")
-
-# Save the images
-provider.save(images, dir="my_images")
-```
-
-### Asynchronous Usage
-
-```python
-import asyncio
-from webscout import AsyncImgSys
-
-async def main():
-    # Initialize the provider
-    provider = AsyncImgSys()
-    
-    # Generate images
-    images = await provider.generate("A cool cyberpunk city at night")
-    
-    # Save the images
-    await provider.save(images, dir="my_images")
-
-# Run the async function
-asyncio.run(main())
-```
-
-### Advanced Usage
-
-```python
-from webscout import ImgSys
-
-# Initialize with custom settings
-provider = ImgSys(
-    timeout=30,  # Custom timeout in seconds
-    proxies={    # Optional proxy configuration
-        "http": "http://proxy:8080",
-        "https": "https://proxy:8080"
-    }
-)
-
-# Generate images with custom retry settings
-images = provider.generate(
-    prompt="A majestic dragon in a fantasy landscape",
-    max_retries=5,    # More retry attempts
-    retry_delay=10    # Longer delay between retries
-)
-
-# Save with custom naming
-provider.save(
-    images,
-    name="dragon_art",
-    dir="fantasy_images",
-    filenames_prefix="fantasy_"
-)
-```
-
-## API Reference 📚
-
-### ImgSys Class
-
-#### Constructor
-
-```python
-def __init__(
-    self,
-    timeout: int = 60,
-    proxies: Optional[dict] = None
-)
-```
-
-Parameters:
-- `timeout` (int): HTTP request timeout in seconds (default: 60)
-- `proxies` (dict, optional): Proxy configuration for requests
-
-#### Methods
-
-##### generate()
-
-```python
-def generate(
-    self,
-    prompt: str,
-    max_retries: int = 3,
-    retry_delay: int = 5
-) -> List[bytes]
-```
-
-Generate images from a text prompt.
-
-Parameters:
-- `prompt` (str): Your image description
-- `max_retries` (int): Max retry attempts if something fails (default: 3)
-- `retry_delay` (int): Seconds to wait between retries (default: 5)
-
-Returns:
-- `List[bytes]`: Generated images as bytes
-
-##### save()
-
-```python
-def save(
-    self,
-    response: List[bytes],
-    name: Optional[str] = None,
-    dir: Optional[Union[str, Path]] = None,
-    filenames_prefix: str = ""
-) -> List[str]
-```
-
-Save generated images to disk.
-
-Parameters:
-- `response` (List[bytes]): Generated images
-- `name` (str, optional): Custom name for images
-- `dir` (Union[str, Path], optional): Save directory (default: current directory)
-- `filenames_prefix` (str): Prefix for image filenames
-
-Returns:
-- `List[str]`: Paths to saved images
-
-### AsyncImgSys Class
-
-The `AsyncImgSys` class provides the same functionality as `ImgSys` but with async/await support. All methods are prefixed with `async` and should be called with `await`.
-
-## Error Handling 🛡️
-
-The provider includes comprehensive error handling:
-
-- Input validation for empty prompts
-- Retry logic for failed API calls
-- Proper exception handling for network issues
-- Graceful handling of API response errors
-
-## Contributing 🤝
-
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-## License 📄
-
-This provider is part of the Webscout package and is licensed under the same terms. 

webscout/Provider/TTI/ImgSys/__init__.py

@@ -1,23 +0,0 @@
-"""ImgSys Provider Package - Generate images from multiple providers! 🎨
-
-Examples:
-    >>> # Synchronous usage
-    >>> from webscout import ImgSys
-    >>> provider = ImgSys()
-    >>> images = provider.generate("A cool cyberpunk city")
-    >>> provider.save(images, dir="my_images")
-    >>> 
-    >>> # Asynchronous usage
-    >>> import asyncio
-    >>> from webscout import AsyncImgSys
-    >>> async def main():
-    ...     provider = AsyncImgSys()
-    ...     images = await provider.generate("A cool cyberpunk city")
-    ...     await provider.save(images, dir="my_images")
-    >>> asyncio.run(main())
-"""
-
-from .sync_imgsys import ImgSys
-from .async_imgsys import AsyncImgSys
-
-__all__ = ["ImgSys", "AsyncImgSys"]