SimplerLLM 0.3.3.1__tar.gz → 0.3.3.2__tar.gz

{simplerllm-0.3.3.1 → simplerllm-0.3.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: SimplerLLM
-Version: 0.3.3.1
+Version: 0.3.3.2
 Summary: An easy-to-use Library for interacting with language models.
 Home-page: https://github.com/hassancs91/SimplerLLM
 Author: Hasan Aboul Hasan
@@ -45,14 +45,19 @@ Requires-Dist: qdrant-client==1.14.3
 Requires-Dist: voyageai==0.3.3
 Requires-Dist: pydub>=0.25.1
 Requires-Dist: elevenlabs>=2.22.0
-Requires-Dist: sounddevice>=0.4.6
-Requires-Dist: pynput>=1.7.6
 Requires-Dist: moviepy>=1.0.3
 Requires-Dist: yt-dlp>=2023.3.4
 Provides-Extra: voice
 Requires-Dist: pygame>=2.5.0; extra == "voice"
+Requires-Dist: sounddevice>=0.4.6; extra == "voice"
+Requires-Dist: pynput>=1.7.6; extra == "voice"
+Provides-Extra: live-voice
+Requires-Dist: sounddevice>=0.4.6; extra == "live-voice"
+Requires-Dist: pynput>=1.7.6; extra == "live-voice"
 Provides-Extra: all
 Requires-Dist: pygame>=2.5.0; extra == "all"
+Requires-Dist: sounddevice>=0.4.6; extra == "all"
+Requires-Dist: pynput>=1.7.6; extra == "all"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier

{simplerllm-0.3.3.1 → simplerllm-0.3.3.2}/SimplerLLM/__init__.py

@@ -82,10 +82,8 @@ from .voice import (
     VoiceTurnResult,
     VoiceChatSession,
     ConversationManager,
-    LiveVoiceChat,
     LiveVoiceChatConfig,
-    AudioRecorder,
-    AudioPlayer,
+    _LIVE_VOICE_AVAILABLE,
     DialogueGenerator,
     Dialogue,
     DialogueLine,
@@ -115,6 +113,14 @@ from .voice import (
     RealtimeVoiceChatConfig,
 )
 
+# LiveVoiceChat requires PortAudio - import conditionally
+if _LIVE_VOICE_AVAILABLE:
+    from .voice import LiveVoiceChat, AudioRecorder, AudioPlayer
+else:
+    LiveVoiceChat = None
+    AudioRecorder = None
+    AudioPlayer = None
+
 # Image module exports
 from .image import (
     ImageGenerator,
@@ -208,11 +214,8 @@ __all__ = [
     'VoiceTurnResult',
     'VoiceChatSession',
     'ConversationManager',
-    # Voice module - LiveVoiceChat
-    'LiveVoiceChat',
+    # Voice module - LiveVoiceChat (config always available, others require PortAudio)
     'LiveVoiceChatConfig',
-    'AudioRecorder',
-    'AudioPlayer',
     # Voice module - Dialogue
     'DialogueGenerator',
     'Dialogue',
@@ -253,3 +256,7 @@ __all__ = [
     'GoogleImageGenerator',
     'ImageGenerationResponse',
 ]
+
+# Conditionally add LiveVoiceChat exports if PortAudio is available
+if _LIVE_VOICE_AVAILABLE:
+    __all__.extend(['LiveVoiceChat', 'AudioRecorder', 'AudioPlayer'])

{simplerllm-0.3.3.1 → simplerllm-0.3.3.2}/SimplerLLM/voice/__init__.py

@@ -9,12 +9,21 @@ from .voice_chat import (
     VoiceChatSession,
     ConversationManager
 )
-from .live_voice_chat import (
-    LiveVoiceChat,
-    LiveVoiceChatConfig,
-    AudioRecorder,
-    AudioPlayer
-)
+from .live_voice_chat import LiveVoiceChatConfig
+
+# LiveVoiceChat requires sounddevice/pynput which need PortAudio
+try:
+    from .live_voice_chat import (
+        LiveVoiceChat,
+        AudioRecorder,
+        AudioPlayer
+    )
+    _LIVE_VOICE_AVAILABLE = True
+except (ImportError, OSError):
+    LiveVoiceChat = None
+    AudioRecorder = None
+    AudioPlayer = None
+    _LIVE_VOICE_AVAILABLE = False
 from .dialogue_generator import (
     DialogueGenerator,
     Dialogue,
@@ -71,11 +80,9 @@ __all__ = [
     'VoiceTurnResult',
     'VoiceChatSession',
     'ConversationManager',
-    # LiveVoiceChat
-    'LiveVoiceChat',
+    # LiveVoiceChat (config always available, others require PortAudio)
     'LiveVoiceChatConfig',
-    'AudioRecorder',
-    'AudioPlayer',
+    '_LIVE_VOICE_AVAILABLE',
     # Dialogue Generator
     'DialogueGenerator',
     'Dialogue',
@@ -108,3 +115,7 @@ __all__ = [
     'RealtimeVoiceChat',
     'RealtimeVoiceChatConfig',
 ]
+
+# Conditionally add LiveVoiceChat exports if available
+if _LIVE_VOICE_AVAILABLE:
+    __all__.extend(['LiveVoiceChat', 'AudioRecorder', 'AudioPlayer'])

simplerllm-0.3.3.2/SimplerLLM/voice/live_voice_chat/__init__.py

@@ -0,0 +1,17 @@
+from .models import LiveVoiceChatConfig
+
+# These imports may fail if sounddevice/pynput not available (requires PortAudio)
+try:
+    from .live_voice_chat import LiveVoiceChat
+    from .audio_recorder import AudioRecorder
+    from .audio_player import AudioPlayer
+    _LIVE_VOICE_AVAILABLE = True
+except (ImportError, OSError):
+    LiveVoiceChat = None
+    AudioRecorder = None
+    AudioPlayer = None
+    _LIVE_VOICE_AVAILABLE = False
+
+__all__ = ['LiveVoiceChatConfig', '_LIVE_VOICE_AVAILABLE']
+if _LIVE_VOICE_AVAILABLE:
+    __all__.extend(['LiveVoiceChat', 'AudioRecorder', 'AudioPlayer'])

{simplerllm-0.3.3.1 → simplerllm-0.3.3.2}/SimplerLLM/voice/live_voice_chat/audio_player.py

@@ -1,7 +1,6 @@
 import os
 import time
 from typing import Optional
-import sounddevice as sd
 import numpy as np
 from SimplerLLM.utils.custom_verbose import verbose_print
 
@@ -14,8 +13,9 @@ class AudioPlayer:
     both blocking and non-blocking playback modes.
     """
 
-    # Class variable to store pygame module after lazy import
+    # Class variables for lazy-loaded modules
     _pygame = None
+    _sounddevice = None
 
     def __init__(self, verbose: bool = False):
         """
@@ -62,6 +62,20 @@ class AudioPlayer:
                     verbose_print(f"Error initializing pygame mixer: {e}", "error")
                 raise
 
+    def _ensure_sounddevice(self):
+        """Ensure sounddevice is available for streaming."""
+        if AudioPlayer._sounddevice is None:
+            try:
+                import sounddevice as sd
+                AudioPlayer._sounddevice = sd
+            except (ImportError, OSError) as e:
+                raise ImportError(
+                    "sounddevice is required for audio streaming but not available. "
+                    "Install with: pip install sounddevice>=0.4.6 "
+                    "Also ensure PortAudio is installed on your system."
+                ) from e
+        return AudioPlayer._sounddevice
+
     def play(
         self,
         audio_path: str,
@@ -249,7 +263,7 @@ class AudioPlayer:
             )
 
         # Create output stream
-        self._output_stream = sd.OutputStream(
+        self._output_stream = self._ensure_sounddevice().OutputStream(
             samplerate=sample_rate,
             channels=channels,
             dtype=dtype,

{simplerllm-0.3.3.1 → simplerllm-0.3.3.2}/SimplerLLM/voice/live_voice_chat/audio_recorder.py

@@ -1,12 +1,45 @@
-import sounddevice as sd
 import numpy as np
 from scipy.io import wavfile
 import tempfile
 import os
 from typing import Optional
-from pynput import keyboard
 from SimplerLLM.utils.custom_verbose import verbose_print
 
+# Lazy-loaded dependencies (for optional audio hardware support)
+_sounddevice = None
+_pynput_keyboard = None
+
+
+def _ensure_sounddevice():
+    """Lazily import sounddevice when actually needed."""
+    global _sounddevice
+    if _sounddevice is None:
+        try:
+            import sounddevice as sd
+            _sounddevice = sd
+        except (ImportError, OSError) as e:
+            raise ImportError(
+                "sounddevice is required for audio recording but not available. "
+                "Install with: pip install sounddevice>=0.4.6 "
+                "Also ensure PortAudio is installed on your system."
+            ) from e
+    return _sounddevice
+
+
+def _ensure_pynput():
+    """Lazily import pynput keyboard when actually needed."""
+    global _pynput_keyboard
+    if _pynput_keyboard is None:
+        try:
+            from pynput import keyboard
+            _pynput_keyboard = keyboard
+        except ImportError as e:
+            raise ImportError(
+                "pynput is required for push-to-talk but not installed. "
+                "Install with: pip install pynput>=1.7.6"
+            ) from e
+    return _pynput_keyboard
+
 
 class AudioRecorder:
     """
@@ -105,7 +138,7 @@ class AudioRecorder:
                         self.is_recording = True
                         if self.verbose:
                             verbose_print("Recording started...", "info")
-                elif k == keyboard.KeyCode.from_char(key):
+                elif k == _ensure_pynput().KeyCode.from_char(key):
                     key_pressed = True
                     if not self.is_recording:
                         self.is_recording = True
@@ -123,7 +156,7 @@ class AudioRecorder:
                     if self.verbose:
                         verbose_print("Recording stopped", "info")
                     return False  # Stop listener
-                elif k == keyboard.KeyCode.from_char(key):
+                elif k == _ensure_pynput().KeyCode.from_char(key):
                     key_pressed = False
                     self.is_recording = False
                     if self.verbose:
@@ -133,14 +166,14 @@ class AudioRecorder:
                 pass
 
         # Start audio stream
-        with sd.InputStream(
+        with _ensure_sounddevice().InputStream(
             samplerate=self.sample_rate,
             channels=self.channels,
             dtype=self.dtype,
             callback=self._audio_callback
         ):
             # Start keyboard listener
-            with keyboard.Listener(on_press=on_press, on_release=on_release) as listener:
+            with _ensure_pynput().Listener(on_press=on_press, on_release=on_release) as listener:
                 listener.join()  # Wait for key release
 
         if not self.recording_data:
@@ -203,6 +236,7 @@ class AudioRecorder:
             verbose_print(f"Recording for {duration} seconds...", "info")
 
         # Record for specified duration
+        sd = _ensure_sounddevice()
         audio_data = sd.rec(
             int(duration * self.sample_rate),
             samplerate=self.sample_rate,
@@ -234,12 +268,12 @@ class AudioRecorder:
         Returns:
             List of device information
         """
-        return sd.query_devices()
+        return _ensure_sounddevice().query_devices()
 
     @staticmethod
     def get_default_device():
         """Get default input device."""
-        return sd.query_devices(kind='input')
+        return _ensure_sounddevice().query_devices(kind='input')
 
     # ========================================================================
     # Streaming methods for Realtime API
@@ -290,7 +324,7 @@ class AudioRecorder:
             )
 
         # Create input stream
-        self._input_stream = sd.InputStream(
+        self._input_stream = _ensure_sounddevice().InputStream(
             samplerate=self._stream_sample_rate,
             channels=self.channels,
             dtype=self.dtype,

{simplerllm-0.3.3.1 → simplerllm-0.3.3.2}/SimplerLLM.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: SimplerLLM
-Version: 0.3.3.1
+Version: 0.3.3.2
 Summary: An easy-to-use Library for interacting with language models.
 Home-page: https://github.com/hassancs91/SimplerLLM
 Author: Hasan Aboul Hasan
@@ -45,14 +45,19 @@ Requires-Dist: qdrant-client==1.14.3
 Requires-Dist: voyageai==0.3.3
 Requires-Dist: pydub>=0.25.1
 Requires-Dist: elevenlabs>=2.22.0
-Requires-Dist: sounddevice>=0.4.6
-Requires-Dist: pynput>=1.7.6
 Requires-Dist: moviepy>=1.0.3
 Requires-Dist: yt-dlp>=2023.3.4
 Provides-Extra: voice
 Requires-Dist: pygame>=2.5.0; extra == "voice"
+Requires-Dist: sounddevice>=0.4.6; extra == "voice"
+Requires-Dist: pynput>=1.7.6; extra == "voice"
+Provides-Extra: live-voice
+Requires-Dist: sounddevice>=0.4.6; extra == "live-voice"
+Requires-Dist: pynput>=1.7.6; extra == "live-voice"
 Provides-Extra: all
 Requires-Dist: pygame>=2.5.0; extra == "all"
+Requires-Dist: sounddevice>=0.4.6; extra == "all"
+Requires-Dist: pynput>=1.7.6; extra == "all"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier

{simplerllm-0.3.3.1 → simplerllm-0.3.3.2}/SimplerLLM.egg-info/requires.txt

@@ -21,13 +21,19 @@ qdrant-client==1.14.3
 voyageai==0.3.3
 pydub>=0.25.1
 elevenlabs>=2.22.0
-sounddevice>=0.4.6
-pynput>=1.7.6
 moviepy>=1.0.3
 yt-dlp>=2023.3.4
 
 [all]
 pygame>=2.5.0
+sounddevice>=0.4.6
+pynput>=1.7.6
+
+[live_voice]
+sounddevice>=0.4.6
+pynput>=1.7.6
 
 [voice]
 pygame>=2.5.0
+sounddevice>=0.4.6
+pynput>=1.7.6

{simplerllm-0.3.3.1 → simplerllm-0.3.3.2}/setup.py

@@ -10,8 +10,9 @@ with open("requirements.txt") as f:
 
 # Optional dependencies for specific features
 extras_require = {
-    'voice': ['pygame>=2.5.0'],  # For AudioPlayer file playback
-    'all': ['pygame>=2.5.0']  # Install all optional dependencies
+    'voice': ['pygame>=2.5.0', 'sounddevice>=0.4.6', 'pynput>=1.7.6'],  # Full voice support
+    'live_voice': ['sounddevice>=0.4.6', 'pynput>=1.7.6'],  # LiveVoiceChat (requires PortAudio)
+    'all': ['pygame>=2.5.0', 'sounddevice>=0.4.6', 'pynput>=1.7.6']  # Install all optional dependencies
 }
 
 # Read the long description from the README file
@@ -20,7 +21,7 @@ with open("README.md", encoding="utf-8") as f:
 
 setup(
     name="SimplerLLM",
-    version="0.3.3.1",
+    version="0.3.3.2",
     author="Hasan Aboul Hasan",
     author_email="hasan@learnwithhasan.com",
     description="An easy-to-use Library for interacting with language models.",

simplerllm-0.3.3.1/SimplerLLM/voice/live_voice_chat/__init__.py

@@ -1,11 +0,0 @@
-from .live_voice_chat import LiveVoiceChat
-from .models import LiveVoiceChatConfig
-from .audio_recorder import AudioRecorder
-from .audio_player import AudioPlayer
-
-__all__ = [
-    'LiveVoiceChat',
-    'LiveVoiceChatConfig',
-    'AudioRecorder',
-    'AudioPlayer',
-]