webscout 8.3.6__py3-none-any.whl → 2025.10.11__py3-none-any.whl

webscout/Provider/TTI/README.md

@@ -1,82 +1,82 @@
-# 🖼️ Webscout Text-to-Image (TTI) Providers
-
-Webscout includes a collection of Text-to-Image providers that follow a common interface inspired by the OpenAI Python client. Each provider exposes an `images.create()` method which returns an `ImageResponse` object containing either image URLs or base64 data.
-
-These providers allow you to easily generate AI‑created art from text prompts while handling image conversion and temporary hosting automatically.
-
-## ✨ Features
-
-- **Unified API** – Consistent `images.create()` method for all providers
-- **Multiple Providers** – Generate images using different third‑party services
-- **URL or Base64 Output** – Receive image URLs (uploaded to catbox.moe/0x0.st) or base64 encoded bytes
-- **PNG/JPEG Conversion** – Images are converted in memory to your chosen format
-- **Model Listing** – Query available models with `provider.models.list()`
-
-## 📦 Supported Providers
-
-| Provider         | Available Models (examples)               |
-| ---------------- | ----------------------------------------- |
-| `AIArta`         | `flux`, `medieval`, `dreamshaper_xl`, ... |
-| `InfipAI`        | `img3`, `img4`, `uncen`                   |
-| `MagicStudioAI`  | `magicstudio`                             |
-| `PixelMuse`      | `flux-schnell`, `imagen-3`, `recraft-v3`  |
-| `PiclumenAI`     | `piclumen-v1`                             |
-| `PollinationsAI` | `flux`, `turbo`, `gptimage`               |
-
-> **Note**: Some providers require the `Pillow` package for image processing.
-
-## 🚀 Quick Start
-
-```python
-from webscout.Provider.TTI import PixelMuse
-
-# Initialize the provider
-client = PixelMuse()
-
-# Generate two images and get URLs
-response = client.images.create(
-    model="flux-schnell",
-    prompt="A futuristic city skyline at sunset",
-    n=2,
-    response_format="url"
-)
-
-print(response)
-```
-
-### Accessing Models
-
-Each provider exposes the models it supports:
-
-```python
-from webscout.Provider.TTI import AIArta
-
-ai = AIArta()
-print(ai.models.list())  # List model identifiers
-```
-
-### Base64 Output
-
-If you prefer the raw image data:
-
-```python
-response = client.images.create(
-    model="flux-schnell",
-    prompt="Crystal mountain landscape",
-    response_format="b64_json"
-)
-# `response.data` will contain base64 strings
-```
-
-## 🔧 Provider Specifics
-
-- **AIArta** – Uses Firebase authentication tokens and supports many tattoo‑style models.
-- **InfipAI** – Offers various models for different image styles.
-- **MagicStudioAI** – Generates images through MagicStudio's public endpoint.
-- **PixelMuse** – Supports several models and converts images from WebP.
-- **PiclumenAI** – Returns JPEG images directly from the API.
-- **PollinationsAI** – Allows setting a custom seed for reproducible results.
-
-## 🤝 Contributing
-
-Contributions and additional providers are welcome! Feel free to submit a pull request.
+# 🖼️ Webscout Text-to-Image (TTI) Providers
+
+Webscout includes a collection of Text-to-Image providers that follow a common interface inspired by the OpenAI Python client. Each provider exposes an `images.create()` method which returns an `ImageResponse` object containing either image URLs or base64 data.
+
+These providers allow you to easily generate AI‑created art from text prompts while handling image conversion and temporary hosting automatically.
+
+## ✨ Features
+
+- **Unified API** – Consistent `images.create()` method for all providers
+- **Multiple Providers** – Generate images using different third‑party services
+- **URL or Base64 Output** – Receive image URLs (uploaded to catbox.moe/0x0.st) or base64 encoded bytes
+- **PNG/JPEG Conversion** – Images are converted in memory to your chosen format
+- **Model Listing** – Query available models with `provider.models.list()`
+
+## 📦 Supported Providers
+
+| Provider         | Available Models (examples)               |
+| ---------------- | ----------------------------------------- |
+| `AIArta`         | `flux`, `medieval`, `dreamshaper_xl`, ... |
+| `InfipAI`        | `img3`, `img4`, `uncen`                   |
+| `MagicStudioAI`  | `magicstudio`                             |
+| `PixelMuse`      | `flux-schnell`, `imagen-3`, `recraft-v3`  |
+| `PiclumenAI`     | `piclumen-v1`                             |
+| `PollinationsAI` | `flux`, `turbo`, `gptimage`               |
+
+> **Note**: Some providers require the `Pillow` package for image processing.
+
+## 🚀 Quick Start
+
+```python
+from webscout.Provider.TTI import PixelMuse
+
+# Initialize the provider
+client = PixelMuse()
+
+# Generate two images and get URLs
+response = client.images.create(
+    model="flux-schnell",
+    prompt="A futuristic city skyline at sunset",
+    n=2,
+    response_format="url"
+)
+
+print(response)
+```
+
+### Accessing Models
+
+Each provider exposes the models it supports:
+
+```python
+from webscout.Provider.TTI import AIArta
+
+ai = AIArta()
+print(ai.models.list())  # List model identifiers
+```
+
+### Base64 Output
+
+If you prefer the raw image data:
+
+```python
+response = client.images.create(
+    model="flux-schnell",
+    prompt="Crystal mountain landscape",
+    response_format="b64_json"
+)
+# `response.data` will contain base64 strings
+```
+
+## 🔧 Provider Specifics
+
+- **AIArta** – Uses Firebase authentication tokens and supports many tattoo‑style models.
+- **InfipAI** – Offers various models for different image styles.
+- **MagicStudioAI** – Generates images through MagicStudio's public endpoint.
+- **PixelMuse** – Supports several models and converts images from WebP.
+- **PiclumenAI** – Returns JPEG images directly from the API.
+- **PollinationsAI** – Allows setting a custom seed for reproducible results.
+
+## 🤝 Contributing
+
+Contributions and additional providers are welcome! Feel free to submit a pull request.

webscout/Provider/TTI/__init__.py

@@ -1,12 +1,33 @@
-from .pollinations import *
-from .piclumen import *
-from .magicstudio import *
-from .pixelmuse import *
-from .aiarta import *
-from .gpt1image import *
-from .imagen import *
-from .together import *
-from .bing import *
-from .infip import *
-from .monochat import *
-from .venice import *
+# This file marks the directory as a Python package.
+
+import os
+import importlib
+from pathlib import Path
+
+# Get current directory
+current_dir = Path(__file__).parent
+
+# List to store all exported names
+__all__ = []
+
+# Auto-import all .py files (except __init__.py)
+for file_path in current_dir.glob("*.py"):
+    if file_path.name != "__init__.py":
+        module_name = file_path.stem
+        try:
+            module = importlib.import_module(f".{module_name}", package=__name__)
+            
+            # Import the main class (assumes class name matches filename)
+            class_name = module_name
+            if hasattr(module, class_name):
+                globals()[class_name] = getattr(module, class_name)
+                __all__.append(class_name)
+            else:
+                # If no matching class, import all public attributes
+                for attr_name in dir(module):
+                    if not attr_name.startswith('_'):
+                        globals()[attr_name] = getattr(module, attr_name)
+                        if attr_name not in __all__:
+                            __all__.append(attr_name)
+        except ImportError:
+            pass  # Skip files that can't be imported