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

webscout/Provider/TTI/talkai/README.md

@@ -0,0 +1,139 @@
+# 🎨 TalkaiImager - Fire AI Art Generator! 🔥
+
+Yo fam! Welcome to TalkaiImager - your go-to provider for creating some absolutely fire AI art! 🎨
+
+## 🚀 Features
+
+- Both sync and async support for maximum flexibility 💪
+- Fire error handling for smooth operation 🛡️
+- Optional logging with cyberpunk vibes 🌟
+- Dynamic user agents for stealth mode 🥷
+- Proxy support for extra privacy 🔒
+- Customizable timeouts and retries ⚙️
+- Smart retry mechanism 🔄
+
+## 💫 Installation
+
+```bash
+pip install webscout  # All you need fam! 🔥
+```
+
+## 🎯 Usage
+
+### 🔥 Sync Way (TalkaiImager)
+
+```python
+from webscout import TalkaiImager
+
+# Initialize with fire logging! 🚀
+imager = TalkaiImager(logging=True)
+
+# Generate a single image
+images = imager.generate("Epic dragon breathing fire")
+paths = imager.save(images)
+print(paths)  # ['epic_dragon_0.png']
+
+# Generate multiple images with retries
+images = imager.generate(
+    "Cyberpunk city at night",
+    amount=3,
+    max_retries=5,
+    retry_delay=3
+)
+paths = imager.save(images)
+print(paths)  # ['cyberpunk_city_0.png', 'cyberpunk_city_1.png', 'cyberpunk_city_2.png']
+
+# Stealth mode (no logging)
+quiet_imager = TalkaiImager(logging=False)
+images = quiet_imager.generate("Secret art")
+paths = quiet_imager.save(images)
+```
+
+### ⚡ Async Way (AsyncTalkaiImager)
+
+```python
+from webscout import AsyncTalkaiImager
+import asyncio
+
+async def generate_art():
+    # Initialize with fire logging! 🚀
+    imager = AsyncTalkaiImager(logging=True)
+    
+    # Generate multiple images
+    images = await imager.generate(
+        "Epic dragon breathing fire",
+        amount=2,
+        max_retries=3,
+        retry_delay=5
+    )
+    paths = await imager.save(images)
+    print(paths)  # ['epic_dragon_0.png', 'epic_dragon_1.png']
+
+    # Custom save location
+    images = await imager.generate("Cool art")
+    paths = await imager.save(images, dir="my_art", filenames_prefix="fire_")
+
+# Run it!
+asyncio.run(generate_art())
+```
+
+### 🛠️ Advanced Usage
+
+```python
+# With proxy and custom timeout
+imager = TalkaiImager(
+    timeout=120,
+    proxies={
+        'http': 'http://10.10.10.1:8000',
+        'https': 'http://10.10.10.1:8000'
+    },
+    logging=True
+)
+
+# Custom save options
+images = imager.generate(
+    "Cool art",
+    max_retries=5,
+    retry_delay=3
+)
+paths = imager.save(
+    images,
+    name="masterpiece",
+    dir="my_art_folder",
+    filenames_prefix="fire_"
+)
+```
+
+## ⚡ Error Handling
+
+We got your back with proper error handling:
+
+```python
+try:
+    images = imager.generate("Cool art")
+    paths = imager.save(images)
+except exceptions.APIConnectionError as e:
+    print("Connection issues! Check your internet! 🌐")
+except exceptions.InvalidResponseError as e:
+    print("Invalid response from API! 🚫")
+except exceptions.FailedToGenerateResponseError as e:
+    print("Failed to generate image! 😢")
+except Exception as e:
+    print(f"Something went wrong fam: {e} 😢")
+```
+
+## 🔒 Security Tips
+
+- Use proxies for extra privacy 🛡️
+- Enable stealth mode (logging=False) for sensitive ops 🤫
+- Don't expose sensitive info in prompts 🔐
+- Use custom timeouts for stability 🕒
+
+## 🎛️ Parameters Guide
+
+- `amount`: Number of images to generate (default: 1)
+- `max_retries`: Number of retry attempts (default: 3)
+- `retry_delay`: Seconds between retries (default: 5)
+- `timeout`: Request timeout in seconds (default: 60)
+
+Made with 💖 by the HelpingAI Team! Keep it real fam! 🔥👑

webscout/Provider/TTS/README.md

@@ -0,0 +1,192 @@
+# 🎙️ Webscout Text-to-Speech (TTS) Providers
+
+## Overview
+
+Webscout's TTS Providers offer a versatile and powerful text-to-speech conversion library with support for multiple providers and advanced features.
+
+## 🌟 Features
+
+- **Multiple TTS Providers**: Support for various text-to-speech services
+- **Concurrent Audio Generation**: Efficiently process long texts
+- **Flexible Voice Selection**: Choose from a wide range of voices
+- **Robust Error Handling**: Comprehensive logging and error management
+- **Temporary File Management**: Automatically manages temporary audio files
+- **Cross-Platform Compatibility**: Works seamlessly across different environments
+- **Custom Save Locations**: Save audio files to specific destinations
+- **Audio Streaming**: Stream audio data in chunks for real-time applications
+
+## 📦 Supported TTS Providers
+
+1. **ElevenlabsTTS**
+2. **GesseritTTS**
+3. **MurfAITTS**
+4. **ParlerTTS**
+5. **DeepgramTTS**
+6. **StreamElementsTTS**
+7. **SpeechMaTTS**
+8. **SthirTTS**
+## 🚀 Installation
+
+```bash
+pip install webscout
+```
+
+## 💻 Basic Usage
+
+```python
+from webscout.Provider.TTS import ElevenlabsTTS
+
+# Initialize the TTS provider
+tts = ElevenlabsTTS()
+
+# Generate speech from text
+text = "Hello, this is a test of text-to-speech conversion."
+audio_file = tts.tts(text, voice="Brian")
+
+# Save the audio to a specific location
+saved_path = tts.save_audio(audio_file, destination="my_speech.mp3")
+print(f"Audio saved to: {saved_path}")
+
+# Stream audio in chunks
+for chunk in tts.stream_audio(text, voice="Brian"):
+    # Process each chunk (e.g., send to a websocket, write to a stream, etc.)
+    process_audio_chunk(chunk)
+```
+
+## 🎛️ Advanced Configuration
+
+### Voice Selection
+
+Each TTS provider offers multiple voices:
+
+```python
+# List available voices
+print(tts.all_voices.keys())
+
+# Select a specific voice
+audio_file = tts.tts(text, voice="Alice")
+```
+
+### Verbose Logging
+
+Enable detailed logging for debugging:
+
+```python
+audio_file = tts.tts(text, verbose=True)
+```
+
+## 🔧 Provider-Specific Details
+
+### ElevenlabsTTS
+
+- Supports multiple English voices
+- Multilingual text-to-speech
+
+### GesseritTTS
+
+- Offers unique voice characteristics
+- Supports voice description customization
+
+### MurfAITTS
+
+- Provides specific voice models
+- Supports custom voice descriptions
+
+### ParlerTTS
+
+- Uses Gradio Client for TTS generation
+- Supports large and small model variants
+
+### DeepgramTTS
+
+- Multiple voice options
+- Advanced voice selection
+
+### StreamElementsTTS
+
+- Wide range of international voices
+
+### SpeechMaTTS
+
+- Multilingual voices (Ava, Emma, Andrew, Brian)
+- Adjustable pitch and speech rate
+- Fast audio generation
+
+## 🛡️ Error Handling
+
+```python
+try:
+    audio_file = tts.tts(text)
+except exceptions.FailedToGenerateResponseError as e:
+    print(f"TTS generation failed: {e}")
+```
+
+## 🌐 Proxy Support
+
+```python
+# Use with proxy
+tts = ElevenlabsTTS(proxies={
+    'http': 'http://proxy.example.com:8080',
+    'https': 'https://proxy.example.com:8080'
+})
+```
+
+## 💾 Custom Audio Saving
+
+Save generated audio to a specific location:
+
+```python
+# Generate speech
+audio_file = tts.tts(text, voice="Brian")
+
+# Save to a specific file
+tts.save_audio(audio_file, destination="path/to/output.mp3")
+
+# Save to a specific directory with default filename
+tts.save_audio(audio_file, destination="path/to/directory/")
+
+# Save with default location (current directory with timestamp)
+saved_path = tts.save_audio(audio_file)
+print(f"Saved to: {saved_path}")
+```
+
+## 📼 Audio Streaming
+
+Stream audio data in chunks for real-time applications:
+
+```python
+# Stream audio in chunks
+for chunk in tts.stream_audio(text, voice="Brian", chunk_size=2048):
+    # Example: Send to a websocket
+    websocket.send(chunk)
+
+    # Example: Write to an audio stream
+    audio_stream.write(chunk)
+
+    # Example: Process in real-time
+    process_audio_data(chunk)
+```
+
+## ⏱️ Async Support
+
+Use the async versions for non-blocking operations:
+
+```python
+from webscout.Provider.TTS import AsyncElevenlabsTTS
+import asyncio
+
+async def main():
+    tts = AsyncElevenlabsTTS()
+
+    # Generate speech
+    audio_file = await tts.tts(text, voice="Brian")
+
+    # Save to a specific location
+    saved_path = await tts.save_audio(audio_file, destination="output.mp3")
+
+    # Stream audio
+    async for chunk in tts.stream_audio(text, voice="Brian"):
+        await process_chunk(chunk)
+
+asyncio.run(main())
+```

webscout/Provider/TTS/__init__.py

@@ -5,4 +5,5 @@ from .deepgram import *
 from .elevenlabs import *
 from .murfai import *
 from .gesserit import *
-from .speechma import *
+from .speechma import *
+from .sthir import *