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

webscout/Provider/TTI/FreeAIPlayground/async_freeaiplayground.py

@@ -0,0 +1,181 @@
+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

@@ -0,0 +1,180 @@
+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

@@ -0,0 +1,174 @@
+# 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

@@ -0,0 +1,23 @@
+"""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"]