webscout 7.5__py3-none-any.whl → 7.6__py3-none-any.whl

webscout/Provider/TTI/fastflux/sync_fastflux.py

@@ -0,0 +1,247 @@
+"""FastFluxImager Synchronous Provider - Generate stunning AI art with FastFlux! 🎨
+
+Examples:
+    >>> from webscout import FastFluxImager
+    >>> provider = FastFluxImager()
+    >>> 
+    >>> # Generate a single image
+    >>> images = provider.generate("A cool cyberpunk city at night")
+    >>> paths = provider.save(images, dir="my_images")
+    >>> 
+    >>> # Generate multiple images with different settings
+    >>> images = provider.generate(
+    ...     prompt="Epic dragon breathing fire",
+    ...     amount=2, 
+    ...     model="flux_1_schnell"
+    ... )
+    >>> provider.save(images, dir="dragon_pics")
+"""
+
+import requests
+import base64
+import json
+import os
+import time
+from typing import List, Optional, Union
+from requests.exceptions import RequestException
+from pathlib import Path
+
+from webscout.AIbase import ImageProvider
+from webscout.litagent import LitAgent
+
+# Get a fresh user agent! 🔄
+agent = LitAgent()
+
+class FastFluxImager(ImageProvider):
+    """Your go-to provider for generating fire images with FastFlux! 🎨
+
+    Examples:
+        >>> provider = FastFluxImager()
+        >>> # Generate one image with default model
+        >>> image = provider.generate("A futuristic city")
+        >>> provider.save(image, "city.png")
+        >>> 
+        >>> # Generate multiple images with specific model
+        >>> images = provider.generate(
+        ...     prompt="Space station",
+        ...     amount=3,
+        ...     model="flux_1_dev"
+        ... )
+        >>> provider.save(images, dir="space_pics")
+    """
+
+    AVAILABLE_MODELS = [
+        "flux_1_schnell",  # Fast generation model (default)
+        "flux_1_dev",      # Developer model
+        "sana_1_6b"        # SANA 1.6B model
+    ]
+    
+
+    def __init__(self, timeout: int = 60, proxies: dict = None):
+        """Initialize your FastFluxImager provider with custom settings
+
+        Examples:
+            >>> provider = FastFluxImager(timeout=120)
+            >>> provider = FastFluxImager(proxies={"http": "http://proxy:8080"})
+
+        Args:
+            timeout (int): HTTP request timeout in seconds (default: 60)
+            proxies (dict, optional): Proxy configuration for requests
+            logging (bool): Enable/disable logging (default: True)
+        """
+        self.api_endpoint = "https://api.fastflux.co/v1/images/generate"
+        self.headers = {
+            "accept": "application/json, text/plain, */*",
+            "content-type": "application/json",
+            "origin": "https://fastflux.co",
+            "referer": "https://fastflux.co/",
+            "user-agent": agent.random()
+        }
+        self.session = requests.Session()
+        self.session.headers.update(self.headers)
+        if proxies:
+            self.session.proxies.update(proxies)
+        self.timeout = timeout
+        self.prompt: str = "AI-generated image - webscout"
+        self.image_extension: str = "png"
+
+
+    def generate(
+        self,
+        prompt: str,
+        amount: int = 1,
+        model: str = "flux_1_schnell",
+        size: str = "1_1",
+        is_public: bool = False,
+        max_retries: int = 3,
+        retry_delay: int = 5
+    ) -> List[bytes]:
+        """Generate some fire images from your prompt! 🎨
+
+        Examples:
+            >>> provider = FastFluxImager()
+            >>> # Basic usage
+            >>> images = provider.generate("Cool art")
+            >>> # Advanced usage
+            >>> images = provider.generate(
+            ...     prompt="Epic dragon",
+            ...     amount=2,
+            ...     model="flux_1_dev",
+            ...     size="16_9"
+            ... )
+
+        Args:
+            prompt (str): Your image description
+            amount (int): How many images you want (default: 1)
+            model (str): Model to use - check AVAILABLE_MODELS (default: "flux_1_schnell")
+            size (str): Image size ratio (default: "1_1")
+            is_public (bool): Whether to make the image public (default: False)
+            max_retries (int): Max retry attempts if something fails (default: 3)
+            retry_delay (int): Seconds to wait between retries (default: 5)
+
+        Returns:
+            List[bytes]: Your generated images
+
+        Raises:
+            ValueError: If the inputs ain't valid
+            RequestException: If the API calls fail after retries
+        """
+        if not prompt:
+            raise ValueError("Yo fam, the prompt can't be empty! 🤔")
+        if not isinstance(amount, int) or amount < 1:
+            raise ValueError("Amount needs to be a positive number! 📈")
+        if model not in self.AVAILABLE_MODELS:
+            raise ValueError(f"Model must be one of {self.AVAILABLE_MODELS}! 🎯")
+        if size not in self.AVAILABLE_SIZES:
+            raise ValueError(f"Size must be one of {self.AVAILABLE_SIZES}! 📏")
+
+        self.prompt = prompt
+        response = []
+
+        # Prepare payload
+        payload = {
+            "prompt": prompt,
+            "model": model,
+            "size": size,
+            "isPublic": is_public
+        }
+
+        for i in range(amount):
+            for attempt in range(max_retries):
+                try:
+                    if self.logging:
+                        print(f"Generating image {i+1}/{amount}... 🎨")
+                    
+                    resp = self.session.post(
+                        self.api_endpoint,
+                        json=payload,
+                        timeout=self.timeout
+                    )
+                    resp.raise_for_status()
+                    result = resp.json()
+                    
+                    if result and 'result' in result:
+                        # Get base64 data and remove header
+                        image_data = result['result']
+                        base64_data = image_data.split(',')[1]
+                        
+                        # Decode base64 data
+                        image_bytes = base64.b64decode(base64_data)
+                        response.append(image_bytes)
+
+                        break
+                    else:
+                        raise RequestException("Invalid response format")
+                        
+                except RequestException as e:
+                    if attempt == max_retries - 1:
+                        raise RequestException(f"Failed to generate image after {max_retries} attempts: {e}")
+
+                    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 = FastFluxImager()
+            >>> 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)
+
+        name = self.prompt if name is None else name
+        
+        # Clean up name for filename use
+        safe_name = "".join(c if c.isalnum() or c in "_-" else "_" for c in name)
+        safe_name = safe_name[:50]  # Truncate if too long
+        
+        filenames = []
+
+        for i, image in enumerate(response):
+            filename = f"{filenames_prefix}{safe_name}_{i}.{self.image_extension}"
+            filepath = os.path.join(save_dir, filename)
+            
+            with open(filepath, "wb") as f:
+                f.write(image)
+            
+            filenames.append(filename)
+
+        return filenames
+
+
+if __name__ == "__main__":
+    # Example usage
+    provider = FastFluxImager()
+    try:
+        images = provider.generate("A cyberpunk city at night with neon lights", amount=1)
+        paths = provider.save(images, dir="generated_images")
+        print(f"Successfully saved images to: {paths}")
+    except Exception as e:
+        print(f"Oops, something went wrong: {e}")

webscout/Provider/TTS/__init__.py

@@ -1,7 +1,7 @@
 from .streamElements import *
-from .voicepod import *
 from .parler import *
 from .deepgram import *
 from .elevenlabs import *
 from .murfai import *
-from .gesserit import *
+from .gesserit import *
+from .speechma import *

webscout/Provider/TTS/deepgram.py

@@ -2,12 +2,11 @@ import time
 import requests
 import pathlib
 import base64
+import tempfile
 from io import BytesIO
-from playsound import playsound
 from webscout import exceptions
 from webscout.AIbase import TTSProvider
 from concurrent.futures import ThreadPoolExecutor, as_completed
-from webscout.Litlogger import Logger, LogFormat
 from webscout.litagent import LitAgent
 from . import utils 
 
@@ -19,7 +18,6 @@ class DeepgramTTS(TTSProvider):
     headers: dict[str, str] = {
         "User-Agent": LitAgent().random()
     }
-    cache_dir = pathlib.Path("./audio_cache")
     all_voices: dict[str, str] = {
         "Asteria": "aura-asteria-en", "Arcas": "aura-arcas-en", "Luna": "aura-luna-en",
         "Zeus": "aura-zeus-en", "Orpheus": "aura-orpheus-en", "Angus": "aura-angus-en",
@@ -34,11 +32,7 @@ class DeepgramTTS(TTSProvider):
         if proxies:
             self.session.proxies.update(proxies)
         self.timeout = timeout
-        self.logger = Logger(
-            name="DeepgramTTS",
-            format=LogFormat.MODERN_EMOJI,
-
-        )
+        self.temp_dir = tempfile.mkdtemp(prefix="webscout_tts_")
 
     def tts(self, text: str, voice: str = "Brian", verbose: bool = True) -> str:
         """
@@ -62,13 +56,13 @@ class DeepgramTTS(TTSProvider):
         ), f"Voice '{voice}' not one of [{', '.join(self.all_voices.keys())}]"
 
         url = "https://deepgram.com/api/ttsAudioGeneration"
-        filename = self.cache_dir / f"{int(time.time())}.mp3"  
+        filename = pathlib.Path(tempfile.mktemp(suffix=".mp3", dir=self.temp_dir))
 
         # Split text into sentences using the utils module
         sentences = utils.split_sentences(text)
         if verbose:
             for index, sen in enumerate(sentences):
-                self.logger.debug(f"Sentence {index}: {sen}")
+                print(f"[debug] Sentence {index}: {sen}")
 
         def generate_audio_for_chunk(part_text: str, part_number: int):
             """
@@ -103,15 +97,15 @@ class DeepgramTTS(TTSProvider):
                     if response_data:
                         audio_data = base64.b64decode(response_data)
                         if verbose:
-                            self.logger.success(f"Chunk {part_number} processed successfully 🎉")
+                            print(f"[debug] Chunk {part_number} processed successfully")
                         return part_number, audio_data
                     
                     if verbose:
-                        self.logger.warning(f"No data received for chunk {part_number}. Attempt {retry_count + 1}/{max_retries} ⚠️")
+                        print(f"[debug] No data received for chunk {part_number}. Attempt {retry_count + 1}/{max_retries}")
                     
                 except requests.RequestException as e:
                     if verbose:
-                        self.logger.error(f"Error processing chunk {part_number}: {str(e)}. Attempt {retry_count + 1}/{max_retries} 🚨")
+                        print(f"[debug] Error processing chunk {part_number}: {str(e)}. Attempt {retry_count + 1}/{max_retries}")
                     if retry_count == max_retries - 1:
                         raise
                 
@@ -121,9 +115,6 @@ class DeepgramTTS(TTSProvider):
             raise RuntimeError(f"Failed to generate audio for chunk {part_number} after {max_retries} attempts")
 
         try:
-            # Create the audio_cache directory if it doesn't exist
-            self.cache_dir.mkdir(parents=True, exist_ok=True)
-
             # Using ThreadPoolExecutor to handle requests concurrently
             with ThreadPoolExecutor() as executor:
                 futures = {
@@ -148,36 +139,18 @@ class DeepgramTTS(TTSProvider):
                         f.write(audio_chunks[chunk_num])
 
                 if verbose:
-                    self.logger.success(f"Audio saved to {filename} 🎉")
+                    print(f"[debug] Audio saved to {filename}")
                 return str(filename)
 
         except Exception as e:
-            self.logger.critical(f"Failed to generate audio: {str(e)} 🚨")
+            print(f"[debug] Failed to generate audio: {str(e)}") if verbose else None
             raise RuntimeError(f"Failed to generate audio: {str(e)}")
 
-    def play_audio(self, filename: str):
-        """
-        Plays an audio file using playsound.
-
-        Args:
-            filename (str): The path to the audio file.
-
-        Raises:
-            RuntimeError: If there is an error playing the audio.
-        """
-        try:
-            playsound(filename)
-        except Exception as e:
-            self.logger.error(f"Failed to play audio: {str(e)} 🚨")
-            raise RuntimeError(f"Failed to play audio: {str(e)}")
-
 # Example usage
 if __name__ == "__main__":
     deepgram = DeepgramTTS()
     text = "This is a test of the DeepgramTTS text-to-speech API. It supports multiple sentences. Let's see how it works!"
 
-    deepgram.logger.info("Generating audio...")
-    audio_file = deepgram.tts(text, voice="Brian") 
-
-    deepgram.logger.info("Playing audio...")
-    deepgram.play_audio(audio_file)
+    print("[debug] Generating audio...")
+    audio_file = deepgram.tts(text, voice="Asteria") 
+    print(f"Audio saved to: {audio_file}")

webscout/Provider/TTS/elevenlabs.py

@@ -1,11 +1,10 @@
 import time
 import requests
 import pathlib
+import tempfile
 from io import BytesIO
-from playsound import playsound
 from webscout import exceptions
 from webscout.AIbase import TTSProvider
-from webscout.Litlogger import Logger, LogFormat
 from webscout.litagent import LitAgent
 from concurrent.futures import ThreadPoolExecutor, as_completed
 from . import utils
@@ -18,7 +17,6 @@ class ElevenlabsTTS(TTSProvider):
     headers: dict[str, str] = {
         "User-Agent": LitAgent().random()
     }
-    cache_dir = pathlib.Path("./audio_cache")
     all_voices: dict[str, str] = {"Brian": "nPczCjzI2devNBz1zQrb", "Alice":"Xb7hH8MSUJpSbSDYk0k2", "Bill":"pqHfZKP75CvOlQylNhV4", "Callum":"N2lVS1w4EtoT3dr4eOWO", "Charlie":"IKne3meq5aSn9XLyUdCD", "Charlotte":"XB0fDUnXU5powFXDhCwa", "Chris":"iP95p4xoKVk53GoZ742B", "Daniel":"onwK4e9ZLuTAKqWW03F9", "Eric":"cjVigY5qzO86Huf0OWal", "George":"JBFqnCBsd6RMkjVDRZzb", "Jessica":"cgSgspJ2msm6clMCkdW9", "Laura":"FGY2WhTYpPnrIDTdsKH5", "Liam":"TX3LPaxmHKxFdv7VOQHJ", "Lily":"pFZP5JQG7iQjIQuC4Bku", "Matilda":"XrExE9yKIg1WjnnlVkGX", "Sarah":"EXAVITQu4vr4xnSDxMaL", "Will":"bIHbv24MWmeRgasZH58o"}
 
     def __init__(self, timeout: int = 20, proxies: dict = None):
@@ -29,11 +27,7 @@ class ElevenlabsTTS(TTSProvider):
             self.session.proxies.update(proxies)
         self.timeout = timeout
         self.params = {'allow_unauthenticated': '1'}
-        self.logger = Logger(
-            name="ElevenlabsTTS",
-            format=LogFormat.MODERN_EMOJI,
-
-        )
+        self.temp_dir = tempfile.mkdtemp(prefix="webscout_tts_")
 
     def tts(self, text: str, voice: str = "Brian", verbose:bool = True) -> str:
         """
@@ -43,7 +37,7 @@ class ElevenlabsTTS(TTSProvider):
             voice in self.all_voices
         ), f"Voice '{voice}' not one of [{', '.join(self.all_voices.keys())}]"
 
-        filename = self.cache_dir / f"{int(time.time())}.mp3"  
+        filename = pathlib.Path(tempfile.mktemp(suffix=".mp3", dir=self.temp_dir))
 
         # Split text into sentences
         sentences = utils.split_sentences(text)
@@ -56,20 +50,17 @@ class ElevenlabsTTS(TTSProvider):
                     response = self.session.post(f'https://api.elevenlabs.io/v1/text-to-speech/{self.all_voices[voice]}',params=self.params, headers=self.headers, json=json_data, timeout=self.timeout)
                     response.raise_for_status()
 
-                    # Create the audio_cache directory if it doesn't exist
-                    self.cache_dir.mkdir(parents=True, exist_ok=True) 
-
                     # Check if the request was successful
                     if response.ok and response.status_code == 200:
                         if verbose:
-                            self.logger.success(f"Chunk {part_number} processed successfully 🎉")
+                            print(f"[debug] Chunk {part_number} processed successfully")
                         return part_number, response.content
                     else:
                         if verbose:
-                            self.logger.warning(f"No data received for chunk {part_number}. Retrying...")
+                            print(f"[debug] No data received for chunk {part_number}. Retrying...")
                 except requests.RequestException as e:
                     if verbose:
-                        self.logger.error(f"Error for chunk {part_number}: {e}. Retrying... 🔄")
+                        print(f"[debug] Error for chunk {part_number}: {e}. Retrying...")
                     time.sleep(1)
         try:
             # Using ThreadPoolExecutor to handle requests concurrently
@@ -87,51 +78,34 @@ class ElevenlabsTTS(TTSProvider):
                         audio_chunks[part_number] = audio_data  # Store the audio data in correct sequence
                     except Exception as e:
                         if verbose:
-                            self.logger.error(f"Failed to generate audio for chunk {chunk_num}: {e} 🚨")
+                            print(f"[debug] Failed to generate audio for chunk {chunk_num}: {e}")
 
             # Combine audio chunks in the correct sequence
             combined_audio = BytesIO()
             for part_number in sorted(audio_chunks.keys()):
                 combined_audio.write(audio_chunks[part_number])
                 if verbose:
-                    self.logger.debug(f"Added chunk {part_number} to the combined file.")
+                    print(f"[debug] Added chunk {part_number} to the combined file.")
 
             # Save the combined audio data to a single file
             with open(filename, 'wb') as f:
                 f.write(combined_audio.getvalue())
             if verbose:
-                self.logger.info(f"Final Audio Saved as {filename} 🔊")
+                print(f"[debug] Final Audio Saved as {filename}")
             return filename.as_posix()
 
         except requests.exceptions.RequestException as e:
-            self.logger.critical(f"Failed to perform the operation: {e} 🚨")
+            if verbose:
+                print(f"[debug] Failed to perform the operation: {e}")
             raise exceptions.FailedToGenerateResponseError(
                 f"Failed to perform the operation: {e}"
             )
-        
-    def play_audio(self, filename: str):
-        """
-        Plays an audio file using playsound.
-
-        Args:
-            filename (str): The path to the audio file.
-
-        Raises:
-            RuntimeError: If there is an error playing the audio.
-        """
-        try:
-            playsound(filename)
-        except Exception as e:
-            self.logger.error(f"Error playing audio: {e} 🔇")
-            raise RuntimeError(f"Error playing audio: {e}")
 
 # Example usage
 if __name__ == "__main__":
     elevenlabs = ElevenlabsTTS()
     text = "This is a test of the ElevenlabsTTS text-to-speech API. It supports multiple sentences and advanced logging."
 
-    elevenlabs.logger.info("Generating audio...")
-    audio_file = elevenlabs.tts(text, voice="Brian") 
-
-    elevenlabs.logger.info("Playing audio...")
-    elevenlabs.play_audio(audio_file)
+    print("[debug] Generating audio...")
+    audio_file = elevenlabs.tts(text, voice="Brian")
+    print(f"Audio saved to: {audio_file}")

webscout/Provider/TTS/gesserit.py

@@ -3,10 +3,8 @@ import requests
 import pathlib
 import base64
 from io import BytesIO
-from playsound import playsound
 from webscout import exceptions
 from webscout.AIbase import TTSProvider
-from webscout.Litlogger import Logger, LogFormat
 from webscout.litagent import LitAgent
 from concurrent.futures import ThreadPoolExecutor, as_completed
 from . import utils
@@ -37,11 +35,6 @@ class GesseritTTS(TTSProvider):
         if proxies:
             self.session.proxies.update(proxies)
         self.timeout = timeout
-        self.logger = Logger(
-            name="GesseritTTS",
-            format=LogFormat.MODERN_EMOJI,
-
-        )
 
     def tts(self, text: str, voice: str = "Oliver", verbose:bool = True) -> str:
         """Converts text to speech using the GesseritTTS API and saves it to a file."""
@@ -76,14 +69,14 @@ class GesseritTTS(TTSProvider):
                         audio_base64 = data["audioUrl"].split(",")[1]
                         audio_data = base64.b64decode(audio_base64)
                         if verbose:
-                            self.logger.success(f"Chunk {part_number} processed successfully 🎉")
+                            print(f"[debug] Chunk {part_number} processed successfully")
                         return part_number, audio_data
                     else:
                         if verbose:
-                            self.logger.warning(f"No data received for chunk {part_number}. Retrying...")
+                            print(f"[debug] No data received for chunk {part_number}. Retrying...")
                 except requests.RequestException as e:
                     if verbose:
-                        self.logger.error(f"Error for chunk {part_number}: {e}. Retrying... 🔄")
+                        print(f"[debug] Error for chunk {part_number}: {e}. Retrying...")
                     time.sleep(1)
         try:
             # Using ThreadPoolExecutor to handle requests concurrently
@@ -101,51 +94,34 @@ class GesseritTTS(TTSProvider):
                         audio_chunks[part_number] = audio_data  # Store the audio data in correct sequence
                     except Exception as e:
                         if verbose:
-                            self.logger.error(f"Failed to generate audio for chunk {chunk_num}: {e} 🚨")
+                            print(f"[debug] Failed to generate audio for chunk {chunk_num}: {e}")
 
             # Combine audio chunks in the correct sequence
             combined_audio = BytesIO()
             for part_number in sorted(audio_chunks.keys()):
                 combined_audio.write(audio_chunks[part_number])
                 if verbose:
-                    self.logger.debug(f"Added chunk {part_number} to the combined file.")
+                    print(f"[debug] Added chunk {part_number} to the combined file.")
 
             # Save the combined audio data to a single file
             with open(filename, 'wb') as f:
                 f.write(combined_audio.getvalue())
             if verbose:
-                self.logger.info(f"Final Audio Saved as {filename} 🔊")
+                print(f"[debug] Final Audio Saved as {filename}")
             return filename.as_posix()
 
         except requests.exceptions.RequestException as e:
-            self.logger.critical(f"Failed to perform the operation: {e} 🚨")
+            if verbose:
+                print(f"[debug] Failed to perform the operation: {e}")
             raise exceptions.FailedToGenerateResponseError(
                 f"Failed to perform the operation: {e}"
             )
-        
-    def play_audio(self, filename: str):
-        """
-        Plays an audio file using playsound.
-
-        Args:
-            filename (str): The path to the audio file.
-
-        Raises:
-            RuntimeError: If there is an error playing the audio.
-        """
-        try:
-            playsound(filename)
-        except Exception as e:
-            self.logger.error(f"Error playing audio: {e} 🔇")
-            raise RuntimeError(f"Error playing audio: {e}")
 
 # Example usage
 if __name__ == "__main__":
     gesserit = GesseritTTS()
     text = "This is a test of the GesseritTTS text-to-speech API. It supports multiple sentences and advanced logging."
 
-    gesserit.logger.info("Generating audio...")
-    audio_file = gesserit.tts(text, voice="Oliver") 
-
-    gesserit.logger.info("Playing audio...")
-    gesserit.play_audio(audio_file)
+    print("[debug] Generating audio...")
+    audio_file = gesserit.tts(text, voice="Oliver")
+    print(f"Audio saved to: {audio_file}")