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

webscout/Provider/TTI/MagicStudio/sync_magicstudio.py

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

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

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

@@ -1,286 +0,0 @@
-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())