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

webscout/Provider/TTI/Nexra/sync_nexra.py

@@ -0,0 +1,258 @@
+import requests
+import json
+import os
+import time
+from typing import List, Optional, Union
+from pathlib import Path
+from requests.exceptions import RequestException
+
+from webscout.AIbase import ImageProvider
+from webscout.Litlogger import Logger, LogFormat
+from webscout.litagent import LitAgent
+
+# Initialize our fire logger and agent 🔥
+logger = Logger(
+    "Nexra",
+    format=LogFormat.MODERN_EMOJI,
+
+)
+agent = LitAgent()
+
+class NexraImager(ImageProvider):
+    """Your go-to provider for generating fire images with Nexra! 🔥
+
+    Examples:
+        >>> # Basic usage
+        >>> provider = NexraImager()
+        >>> images = provider.generate("Cool art")
+        >>> paths = provider.save(images)
+        >>>
+        >>> # Advanced usage
+        >>> provider = NexraImager(timeout=120)
+        >>> images = provider.generate(
+        ...     prompt="Epic dragon",
+        ...     model="midjourney",
+        ...     additional_params={
+        ...         "data": {
+        ...             "steps": 30,
+        ...             "cfg_scale": 8
+        ...         }
+        ...     }
+        ... )
+        >>> paths = provider.save(images, name="dragon", dir="my_art")
+    """
+
+    AVAILABLE_MODELS = {
+        "standard": [
+            "emi",
+            "stablediffusion-1.5",
+            "stablediffusion-2.1",
+            "sdxl-lora",
+            "dalle",
+            "dalle2",
+            "dalle-mini",
+            "flux",
+            "midjourney"
+        ],
+        "prodia": [
+            "dreamshaperXL10_alpha2.safetensors [c8afe2ef]",
+            "dynavisionXL_0411.safetensors [c39cc051]",
+            "juggernautXL_v45.safetensors [e75f5471]",
+            "realismEngineSDXL_v10.safetensors [af771c3f]",
+            "sd_xl_base_1.0.safetensors [be9edd61]",
+            "animagineXLV3_v30.safetensors [75f2f05b]",
+            "sd_xl_base_1.0_inpainting_0.1.safetensors [5679a81a]",
+            "turbovisionXL_v431.safetensors [78890989]",
+            "devlishphotorealism_sdxl15.safetensors [77cba69f]",
+            "realvisxlV40.safetensors [f7fdcb51]"
+        ]
+    }
+
+    def __init__(self, timeout: int = 60, proxies: dict = {}, logging: bool = True):
+        """Initialize your Nexra provider with custom settings! ⚙️
+
+        Args:
+            timeout (int): Request timeout in seconds (default: 60)
+            proxies (dict): Proxy settings for requests (default: {})
+            logging (bool): Enable fire logging (default: True)
+        """
+        self.url = "https://nexra.aryahcr.cc/api/image/complements"
+        self.headers = {
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+            "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"
+        self.logging = logging
+        if self.logging:
+            logger.info("Nexra provider initialized! 🚀")
+
+    def generate(
+        self,
+        prompt: str,
+        model: str = "midjourney",
+        amount: int = 1,
+        max_retries: int = 3,
+        retry_delay: int = 5,
+        additional_params: Optional[dict] = None
+    ) -> List[bytes]:
+        """Generate some fire images from your prompt! 🎨
+
+        Examples:
+            >>> provider = NexraImager()
+            >>> # Basic usage
+            >>> images = provider.generate("Cool art")
+            >>> # Advanced usage
+            >>> images = provider.generate(
+            ...     prompt="Epic dragon",
+            ...     model="midjourney",
+            ...     amount=3,
+            ...     additional_params={"data": {"steps": 30}}
+            ... )
+
+        Args:
+            prompt (str): Your image description
+            model (str): Model to use (default: "midjourney")
+            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)
+            additional_params (dict, optional): Extra params for the API
+
+        Returns:
+            List[bytes]: Your generated images
+
+        Raises:
+            ValueError: If the inputs ain't valid
+            RequestException: If the API calls fail after retries
+            json.JSONDecodeError: If the API response is invalid
+        """
+        assert bool(prompt), "Prompt cannot be null"
+        assert isinstance(amount, int) and amount > 0, "Amount should be a positive integer"
+        
+        all_models = self.AVAILABLE_MODELS["standard"] + self.AVAILABLE_MODELS["prodia"]
+        assert model in all_models, f"Model should be one of {all_models}"
+
+        self.prompt = prompt
+        response = []
+
+        payload = {
+            "prompt": prompt,
+            "model": "prodia" if model in self.AVAILABLE_MODELS["prodia"] else model,
+        }
+
+        if model in self.AVAILABLE_MODELS["prodia"]:
+            payload["data"] = {
+                "model": model,
+                "steps": 25,
+                "cfg_scale": 7,
+                "sampler": "DPM++ 2M Karras",
+                "negative_prompt": ""
+            }
+        if additional_params:
+            payload.update(additional_params)
+
+        if self.logging:
+            logger.info(f"Generating {amount} images with {model}... 🎨")
+        for attempt in range(max_retries):
+            try:
+                resp = self.session.post(self.url, json=payload, timeout=self.timeout)
+                resp.raise_for_status()
+
+                # Remove leading underscores and then parse JSON
+                response_data = json.loads(resp.text.lstrip("_"))
+
+                if response_data.get("status") and "images" in response_data:
+                    for image_url in response_data["images"]:
+                        img_resp = requests.get(image_url)
+                        img_resp.raise_for_status()
+                        response.append(img_resp.content)
+                    if self.logging:
+                        logger.success("Images generated successfully! 🎉")
+                    break
+                else:
+                    raise Exception("Failed to generate image: " + str(response_data))
+            except json.JSONDecodeError as json_err:
+                if self.logging:
+                    logger.error(f"JSON Decode Error: {json_err} 😢")
+                    logger.debug(f"Raw response: {resp.text}")
+                if attempt == max_retries - 1:
+                    raise
+            except RequestException as e:
+                if self.logging:
+                    logger.error(f"Failed to generate images: {e} 😢")
+                if attempt == max_retries - 1:
+                    raise
+            if self.logging:
+                logger.warning(f"Retrying in {retry_delay} seconds... 🔄")
+            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 = NexraImager()
+            >>> 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)
+            if self.logging:
+                logger.info(f"Created directory: {save_dir} 📁")
+
+        name = self.prompt if name is None else name
+        filenames = []
+
+        if self.logging:
+            logger.info(f"Saving {len(response)} images... 💾")
+        for i, image in enumerate(response):
+            filename = f"{filenames_prefix}{name}_{i}.{self.image_extension}"
+            filepath = os.path.join(save_dir, filename)
+
+            with open(filepath, "wb") as fh:
+                fh.write(image)
+            filenames.append(filename)
+            if self.logging:
+                logger.success(f"Saved image to: {filepath} 💾")
+
+        if self.logging:
+            logger.success(f"Images saved successfully! Check {dir} 🎉")
+        return filenames
+
+if __name__ == "__main__":
+    bot = NexraImager()
+    try:
+        resp = bot.generate("A shiny red sports car speeding down a scenic mountain road", "midjourney")
+        print(bot.save(resp))
+    except Exception as e:
+        logger.error(f"An error occurred: {e} 😢")

webscout/Provider/TTI/PollinationsAI/README.md

@@ -0,0 +1,146 @@
+# PollinationsAI Provider 🎨
+
+A powerful text-to-image generation provider using Pollinations.ai! Generate stunning images with various styles and models. Supports both synchronous and asynchronous operations! 🚀
+
+## Features 💫
+
+- Multiple AI models for different styles 🎭
+- Both sync and async support ⚡
+- Built-in retry logic and error handling 🛡️
+- Easy-to-use interface 🎯
+- Beautiful logging with LitLogger 📝
+- Random user agents with LitAgent 🔄
+
+## Installation 📦
+
+```bash
+pip install webscout
+```
+
+## Quick Start 🚀
+
+### Synchronous Usage
+
+```python
+from webscout import PollinationsAI
+
+# Create provider
+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 settings
+images = provider.generate(
+    prompt="A majestic dragon",
+    amount=3,
+    width=1024,
+    height=1024,
+    model="flux-3d"  # Use 3D style
+)
+provider.save(images, dir="dragon_pics")
+```
+
+### Asynchronous Usage
+
+```python
+import asyncio
+from webscout import AsyncPollinationsAI
+
+async def main():
+    # Create provider
+    provider = AsyncPollinationsAI()
+    
+    # Generate images
+    images = await provider.generate(
+        prompt="A beautiful sunset",
+        amount=2,
+        model="flux-realism"  # Use realistic style
+    )
+    
+    # Save images
+    paths = await provider.save(images, dir="sunset_pics")
+    print(f"Saved images to: {paths}")
+
+# Run async code
+asyncio.run(main())
+```
+
+## Available Models 🎭
+
+| Model | Description | Best For |
+|-------|-------------|----------|
+| `flux` | Default model | General purpose |
+| `flux-realism` | Enhanced realism | Photos, portraits |
+| `flux-cablyai` | CablyAI style | Artistic renders |
+| `flux-anime` | Anime/manga style | Anime art |
+| `flux-3d` | 3D-style renders | 3D scenes |
+| `any-dark` | Dark/gothic style | Dark themes |
+| `flux-pro` | Professional quality | High-quality art |
+| `turbo` | Fast generation | Quick results |
+
+## Advanced Usage 🔧
+
+### Different Models for Different Styles
+
+```python
+# Anime style
+anime_pics = provider.generate(
+    prompt="Cute anime character",
+    model="flux-anime"
+)
+
+# Realistic style
+real_pics = provider.generate(
+    prompt="Professional portrait",
+    model="flux-realism"
+)
+
+# Quick generation
+quick_pics = provider.generate(
+    prompt="Quick concept art",
+    model="turbo"
+)
+```
+
+### Custom Settings
+
+```python
+# Custom timeout and proxies
+provider = PollinationsAI(
+    timeout=30,  # 30 seconds timeout
+    proxies={
+        "http": "http://proxy:8080"
+    }
+)
+
+# Generate high-res images
+images = provider.generate(
+    prompt="Ultra detailed landscape",
+    width=1920,
+    height=1080,
+    model="flux-pro"
+)
+```
+
+## Error Handling 🛡️
+
+The provider includes built-in retry logic and error handling:
+
+```python
+try:
+    images = provider.generate(
+        prompt="Test image",
+        max_retries=3,  # Retry 3 times
+        retry_delay=5   # Wait 5 seconds between retries
+    )
+except Exception as e:
+    print(f"Generation failed: {e}")
+```
+
+## Contributing 🤝
+
+Feel free to contribute! Check out our issues or submit PRs.
+
+Made with 💖 by the HelpingAI Team

webscout/Provider/TTI/PollinationsAI/__init__.py

@@ -0,0 +1,23 @@
+"""PollinationsAI Provider Package - Your go-to for text-to-image generation! 🎨
+
+Examples:
+    >>> # Synchronous usage
+    >>> from webscout import PollinationsAI
+    >>> provider = PollinationsAI()
+    >>> images = provider.generate("A cool cyberpunk city")
+    >>> provider.save(images, dir="my_images")
+    >>> 
+    >>> # Asynchronous usage
+    >>> import asyncio
+    >>> from webscout import AsyncPollinationsAI
+    >>> async def main():
+    ...     provider = AsyncPollinationsAI()
+    ...     images = await provider.generate("A cool cyberpunk city")
+    ...     await provider.save(images, dir="my_images")
+    >>> asyncio.run(main())
+"""
+
+from .sync_pollinations import PollinationsAI
+from .async_pollinations import AsyncPollinationsAI
+
+__all__ = ["PollinationsAI", "AsyncPollinationsAI"]