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

webscout/Provider/TTI/MagicStudio/sync_magicstudio.py

@@ -0,0 +1,109 @@
+import requests
+import os
+import uuid
+import time
+from typing import List, Optional, Union
+from pathlib import Path
+from requests.exceptions import RequestException
+
+from webscout.AIbase import ImageProvider
+from webscout.litagent import LitAgent
+
+agent = LitAgent()
+
+class MagicStudioImager(ImageProvider):
+    """Your go-to provider for generating fire images with MagicStudio! 🎨"""
+    
+    def __init__(self, timeout: int = 60, proxies: dict = {}):
+        """Initialize your MagicStudio provider with custom settings! ⚙️"""
+        self.api_endpoint = "https://ai-api.magicstudio.com/api/ai-art-generator"
+        self.headers = {
+            "Accept": "application/json, text/plain, */*",
+            "User-Agent": agent.random(),
+            "Origin": "https://magicstudio.com",
+            "Referer": "https://magicstudio.com/ai-art-generator/",
+            "DNT": "1",
+            "Sec-GPC": "1"
+        }
+        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 = "jpg"
+
+    def generate(
+        self, 
+        prompt: str,
+        amount: int = 1,
+        max_retries: int = 3,
+        retry_delay: int = 5
+    ) -> List[bytes]:
+        """Generate some fire images from your prompt! 🎨"""
+        if not prompt:
+            raise ValueError("Yo fam, prompt can't be empty! 🚫")
+        if not isinstance(amount, int) or amount < 1:
+            raise ValueError("Amount needs to be a positive number! 📈")
+
+        self.prompt = prompt
+        response = []
+
+        for _ in range(amount):
+            form_data = {
+                "prompt": prompt,
+                "output_format": "bytes",
+                "user_profile_id": "null",
+                "anonymous_user_id": str(uuid.uuid4()),
+                "request_timestamp": time.time(),
+                "user_is_subscribed": "false",
+                "client_id": uuid.uuid4().hex,
+            }
+
+            for attempt in range(max_retries):
+                try:
+                    resp = self.session.post(
+                        self.api_endpoint,
+                        data=form_data,
+                        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! 💾"""
+        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, filenames_prefix + name + count_value + "." + self.image_extension)
+
+            while os.path.isfile(complete_path()):
+                count += 1
+
+            filepath = complete_path()
+            filenames.append(os.path.basename(filepath))
+
+            with open(filepath, "wb") as fh:
+                fh.write(image)
+
+        return filenames

webscout/Provider/TTI/Nexra/README.md

@@ -0,0 +1,155 @@
+# Nexra Provider 🔥
+
+Yo fam! This is the Nexra provider for generating some fire images! Part of the HelpingAI squad! 👑
+
+## Features 💪
+
+- Standard & Prodia models ⚡
+- 19+ fire models to choose from 🎨
+- Smart retry mechanism 🔄
+- Custom parameters support 🛠️
+- Save with custom names 💾
+- Fire logging with cyberpunk theme 🌟
+- Proxy support for stealth mode 🕵️‍♂️
+
+## Quick Start 🚀
+
+### Installation 📦
+
+```bash
+pip install webscout
+```
+
+### Basic Usage 💫
+
+```python
+from webscout import NexraImager
+
+# Basic usage
+provider = NexraImager()
+images = provider.generate("Epic dragon")
+paths = provider.save(images)
+
+# With custom model
+provider = NexraImager()
+images = provider.generate(
+    prompt="Epic dragon",
+    model="midjourney"
+)
+paths = provider.save(images)
+```
+
+## Available Models 🎭
+
+### Standard Models 🌟
+
+| Model | Description | Best For |
+|-------|-------------|----------|
+| `emi` | Eminent AI model | General purpose |
+| `stablediffusion-1.5` | Classic SD model | Proven quality |
+| `stablediffusion-2.1` | Improved SD model | Better quality |
+| `sdxl-lora` | SDXL with LoRA | Custom styles |
+| `dalle` | OpenAI's DALL-E | Clean images |
+| `dalle2` | DALL-E 2 model | High quality |
+| `dalle-mini` | Lightweight DALL-E | Quick generations |
+| `flux` | Standard Flux | General purpose |
+| `midjourney` | MJ style | Artistic images |
+
+### Prodia Models 🚀
+
+| Model | Description |
+|-------|-------------|
+| `dreamshaperXL10_alpha2` | Dreamlike creations |
+| `dynavisionXL_0411` | Dynamic visuals |
+| `juggernautXL_v45` | Powerful generations |
+| `realismEngineSDXL_v10` | Photorealistic images |
+| `sd_xl_base_1.0` | Base SDXL model |
+| `animagineXLV3_v30` | Anime style art |
+| `sd_xl_base_1.0_inpainting` | Inpainting specialist |
+| `turbovisionXL_v431` | Fast generations |
+| `devlishphotorealism_sdxl15` | Ultra-realistic |
+| `realvisxlV40` | Reality-based art |
+
+## Advanced Examples 🔥
+
+### Custom Settings 🛠️
+
+```python
+provider = NexraImager(
+    timeout=120,  # Longer timeout
+    proxies={
+        'http': 'http://proxy.example.com:8080'
+    }
+)
+```
+
+### Prodia Model with Custom Params 📸
+
+```python
+images = provider.generate(
+    prompt="A shiny red sports car",
+    model="realismEngineSDXL_v10.safetensors [af771c3f]",
+    additional_params={
+        "data": {
+            "steps": 30,
+            "cfg_scale": 8,
+            "sampler": "DPM++ 2M Karras",
+            "negative_prompt": "blurry, low quality"
+        }
+    }
+)
+```
+
+### Custom Save Options 💾
+
+```python
+paths = provider.save(
+    images,
+    name="sports_car",  # Custom name
+    dir="my_images",  # Custom directory
+    filenames_prefix="v1_"  # Add prefix
+)
+```
+
+### Error Handling 🛡️
+
+```python
+try:
+    images = provider.generate(
+        prompt="Epic scene",
+        model="midjourney",
+        max_retries=5,  # More retries
+        retry_delay=10  # Longer delay
+    )
+    paths = provider.save(images, dir="scenes")
+except Exception as e:
+    print(f"Oops! Something went wrong: {e}")
+```
+
+## Tips & Tricks 💡
+
+1. Use `midjourney` for artistic images
+2. Use `realismEngineSDXL` for photorealistic shots
+3. Use `animagineXLV3` for anime style
+4. Adjust steps and cfg_scale for better quality
+5. Use custom negative prompts
+6. Set longer timeouts for complex generations
+
+The provider handles common errors:
+
+- Network issues
+- JSON parsing errors
+- API timeouts
+- Invalid inputs
+- File saving errors
+
+## Contributing 🤝
+
+Pull up to the squad! We're always looking for improvements:
+
+1. Fork it
+2. Create your feature branch
+3. Push your changes
+4. Hit us with that pull request
+
+Made with 💖 by the HelpingAI Team

webscout/Provider/TTI/Nexra/__init__.py

@@ -0,0 +1,22 @@
+"""
+Nexra - Your go-to provider for generating fire images! 🔥
+
+Examples:
+    >>> # Sync Usage
+    >>> from webscout import NexraImager
+    >>> provider = NexraImager()
+    >>> images = provider.generate("Cool art")
+    >>> paths = provider.save(images)
+    >>>
+    >>> # Async Usage
+    >>> from webscout import AsyncNexraImager
+    >>> async def example():
+    ...     provider = AsyncNexraImager()
+    ...     images = await provider.generate("Epic dragon")
+    ...     paths = await provider.save(images)
+"""
+
+from .sync_nexra import NexraImager
+from .async_nexra import AsyncNexraImager
+
+__all__ = ["NexraImager", "AsyncNexraImager"]

webscout/Provider/TTI/Nexra/async_nexra.py

@@ -0,0 +1,286 @@
+import aiohttp
+import asyncio
+import json
+import os
+import time
+from typing import List, Optional, Union, AsyncGenerator
+from pathlib import Path
+from aiohttp import ClientError
+
+from webscout.AIbase import AsyncImageProvider
+from webscout.Litlogger import Logger, LogFormat
+from webscout.litagent import LitAgent
+
+# Initialize our fire logger and agent 🔥
+logger = Logger(
+    "AsyncNexra",
+    format=LogFormat.MODERN_EMOJI,
+
+)
+agent = LitAgent()
+
+class AsyncNexraImager(AsyncImageProvider):
+    """Your go-to async provider for generating fire images with Nexra! ⚡
+
+    Examples:
+        >>> # Basic usage
+        >>> provider = AsyncNexraImager()
+        >>> async def example():
+        ...     images = await provider.generate("Cool art")
+        ...     paths = await provider.save(images)
+        >>>
+        >>> # Advanced usage
+        >>> provider = AsyncNexraImager(timeout=120)
+        >>> async def example():
+        ...     images = await provider.generate(
+        ...         prompt="Epic dragon",
+        ...         model="midjourney",
+        ...         additional_params={
+        ...             "data": {
+        ...                 "steps": 30,
+        ...                 "cfg_scale": 8
+        ...             }
+        ...         }
+        ...     )
+        ...     paths = await 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 async 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.timeout = timeout
+        self.proxies = proxies
+        self.prompt: str = "AI-generated image - webscout"
+        self.image_extension: str = "png"
+        self.logging = logging
+        if self.logging:
+            logger.info("AsyncNexra provider initialized! 🚀")
+
+    async 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 asynchronously! ⚡
+
+        Examples:
+            >>> provider = AsyncNexraImager()
+            >>> async def example():
+            ...     # Basic usage
+            ...     images = await provider.generate("Cool art")
+            ...     # Advanced usage
+            ...     images = await 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
+            ClientError: 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)
+
+        async with aiohttp.ClientSession(headers=self.headers) as session:
+            for attempt in range(max_retries):
+                try:
+                    if self.logging:
+                        logger.info(f"Generating {amount} images with {model}... 🎨")
+                    async with session.post(
+                        self.url,
+                        json=payload,
+                        timeout=self.timeout,
+                        proxy=self.proxies.get('http')
+                    ) as resp:
+                        resp.raise_for_status()
+                        text = await resp.text()
+
+                        # Remove leading underscores and then parse JSON
+                        response_data = json.loads(text.lstrip("_"))
+
+                        if response_data.get("status") and "images" in response_data:
+                            for image_url in response_data["images"]:
+                                async with session.get(image_url) as img_resp:
+                                    img_resp.raise_for_status()
+                                    response.append(await img_resp.read())
+                                    if self.logging:
+                                        logger.success(f"Generated image {len(response)}/{amount}! 🎨")
+                            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: {text}")
+                    if attempt == max_retries - 1:
+                        raise
+                except ClientError 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... 🔄")
+                await asyncio.sleep(retry_delay)
+
+        if self.logging:
+            logger.success("Images generated successfully! 🎉")
+        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 = AsyncNexraImager()
+            >>> 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)
+            if self.logging:
+                logger.info(f"Created directory: {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)
+            
+            if self.logging:
+                logger.success(f"Saved image to: {filepath} 💾")
+            return filepath
+
+        # Handle both List[bytes] and AsyncGenerator
+        if isinstance(response, list):
+            image_list = response
+        else:
+            image_list = [chunk async for chunk in response]
+
+        if self.logging:
+            logger.info(f"Saving {len(image_list)} images... 💾")
+        tasks = [save_single_image(img, i) for i, img in enumerate(image_list)]
+        saved_paths = await asyncio.gather(*tasks)
+        if self.logging:
+            logger.success(f"Images saved successfully! Check {dir} 🎉")
+        return saved_paths
+
+if __name__ == "__main__":
+    async def main():
+        bot = AsyncNexraImager()
+        try:
+            resp = await bot.generate("A shiny red sports car speeding down a scenic mountain road", "midjourney")
+            paths = await bot.save(resp)
+            print(paths)
+        except Exception as e:
+            logger.error(f"An error occurred: {e} 😢")
+
+    asyncio.run(main())