abstractvoice 0.2.0__py3-none-any.whl → 0.3.0__py3-none-any.whl

abstractvoice/__main__.py

@@ -15,11 +15,13 @@ def print_examples():
     print("  cli       - Command-line REPL example")
     print("  web       - Web API example")
     print("  simple    - Simple usage example")
+    print("  check-deps - Check dependency compatibility")
     print("\nUsage: python -m abstractvoice <example> [--language <lang>] [args...]")
     print("\nSupported languages: en, fr, es, de, it, ru, multilingual")
     print("\nExamples:")
     print("  python -m abstractvoice cli --language fr    # French CLI")
     print("  python -m abstractvoice simple --language ru # Russian simple example")
+    print("  python -m abstractvoice check-deps           # Check dependencies")
 
 
 def simple_example():
@@ -95,7 +97,7 @@ def simple_example():
 def main():
     """Main entry point."""
     parser = argparse.ArgumentParser(description="AbstractVoice examples")
-    parser.add_argument("example", nargs="?", help="Example to run (cli, web, simple)")
+    parser.add_argument("example", nargs="?", help="Example to run (cli, web, simple, check-deps)")
     parser.add_argument("--language", "--lang", default="en",
                       choices=["en", "fr", "es", "de", "it", "ru", "multilingual"],
                       help="Voice language for examples")
@@ -107,6 +109,16 @@ def main():
         print_examples()
         return
 
+    # Handle check-deps specially (doesn't need language)
+    if args.example == "check-deps":
+        from abstractvoice.dependency_check import check_dependencies
+        try:
+            check_dependencies(verbose=True)
+        except Exception as e:
+            print(f"❌ Error running dependency check: {e}")
+            print("This might indicate a dependency issue.")
+        return
+
     # Set remaining args as sys.argv for the examples, including language
     if args.language != "en":
         remaining = ["--language", args.language] + remaining

abstractvoice/dependency_check.py

@@ -0,0 +1,274 @@
+"""Dependency compatibility checker for AbstractVoice.
+
+This module provides utilities to check dependency versions and compatibility,
+helping users diagnose and resolve installation issues.
+"""
+
+import sys
+import importlib
+from typing import Dict, List, Tuple, Optional
+import warnings
+
+
+class DependencyChecker:
+    """Check and validate AbstractVoice dependencies."""
+
+    # Known compatible version ranges
+    PYTORCH_COMPAT = {
+        "torch": ("2.0.0", "2.4.0"),
+        "torchvision": ("0.15.0", "0.19.0"),
+        "torchaudio": ("2.0.0", "2.4.0"),
+    }
+
+    CORE_DEPS = {
+        "numpy": ("1.24.0", None),
+        "requests": ("2.31.0", None),
+    }
+
+    OPTIONAL_DEPS = {
+        "coqui-tts": ("0.27.0", "0.30.0"),
+        "openai-whisper": ("20230314", None),
+        "sounddevice": ("0.4.6", None),
+        "librosa": ("0.10.0", "0.11.0"),
+        "flask": ("2.0.0", None),
+        "webrtcvad": ("2.0.10", None),
+        "PyAudio": ("0.2.13", None),
+        "soundfile": ("0.12.1", None),
+        "tiktoken": ("0.6.0", None),
+    }
+
+    def __init__(self, verbose: bool = True):
+        self.verbose = verbose
+        self.results = {}
+
+    def _parse_version(self, version_str: str) -> Tuple[int, ...]:
+        """Parse version string into tuple of integers for comparison."""
+        try:
+            # Handle version strings like "20230314" or "2.0.0"
+            if version_str.isdigit():
+                return (int(version_str),)
+
+            # Standard semantic versioning
+            version_parts = version_str.split('.')
+            return tuple(int(part) for part in version_parts if part.isdigit())
+        except (ValueError, AttributeError):
+            return (0,)
+
+    def _check_version_range(self, current: str, min_ver: Optional[str], max_ver: Optional[str]) -> bool:
+        """Check if current version is within the specified range."""
+        current_tuple = self._parse_version(current)
+
+        if min_ver:
+            min_tuple = self._parse_version(min_ver)
+            if current_tuple < min_tuple:
+                return False
+
+        if max_ver:
+            max_tuple = self._parse_version(max_ver)
+            if current_tuple >= max_tuple:
+                return False
+
+        return True
+
+    def _check_package(self, package_name: str, min_ver: Optional[str], max_ver: Optional[str]) -> Dict:
+        """Check a single package installation and version."""
+        try:
+            module = importlib.import_module(package_name.replace('-', '_'))
+            version = getattr(module, '__version__', 'unknown')
+
+            # Special handling for packages with different version attributes
+            if version == 'unknown':
+                if hasattr(module, 'version'):
+                    version = module.version
+                elif hasattr(module, 'VERSION'):
+                    version = module.VERSION
+                elif package_name == 'openai-whisper':
+                    # Whisper uses different versioning
+                    try:
+                        import whisper
+                        version = getattr(whisper, '__version__', 'installed')
+                    except:
+                        version = 'installed'
+
+            compatible = self._check_version_range(str(version), min_ver, max_ver)
+
+            return {
+                'status': 'installed',
+                'version': str(version),
+                'compatible': compatible,
+                'min_version': min_ver,
+                'max_version': max_ver
+            }
+
+        except ImportError:
+            return {
+                'status': 'missing',
+                'version': None,
+                'compatible': False,
+                'min_version': min_ver,
+                'max_version': max_ver
+            }
+        except Exception as e:
+            return {
+                'status': 'error',
+                'version': None,
+                'compatible': False,
+                'error': str(e),
+                'min_version': min_ver,
+                'max_version': max_ver
+            }
+
+    def check_core_dependencies(self) -> Dict:
+        """Check core dependencies (always required)."""
+        results = {}
+        for package, (min_ver, max_ver) in self.CORE_DEPS.items():
+            results[package] = self._check_package(package, min_ver, max_ver)
+        return results
+
+    def check_pytorch_ecosystem(self) -> Dict:
+        """Check PyTorch ecosystem for compatibility issues."""
+        results = {}
+        for package, (min_ver, max_ver) in self.PYTORCH_COMPAT.items():
+            results[package] = self._check_package(package, min_ver, max_ver)
+        return results
+
+    def check_optional_dependencies(self) -> Dict:
+        """Check optional dependencies."""
+        results = {}
+        for package, (min_ver, max_ver) in self.OPTIONAL_DEPS.items():
+            results[package] = self._check_package(package, min_ver, max_ver)
+        return results
+
+    def check_pytorch_conflicts(self) -> List[str]:
+        """Detect specific PyTorch/TorchVision conflicts."""
+        conflicts = []
+
+        try:
+            import torch
+            import torchvision
+
+            torch_version = self._parse_version(torch.__version__)
+            tv_version = self._parse_version(torchvision.__version__)
+
+            # Check known incompatible combinations
+            if torch_version >= (2, 3, 0) and tv_version < (0, 18, 0):
+                conflicts.append(f"PyTorch {torch.__version__} is incompatible with TorchVision {torchvision.__version__}")
+
+            # Test torchvision::nms operator availability
+            try:
+                from torchvision.ops import nms
+                # Try to use nms to check if it actually works
+                import torch
+                boxes = torch.tensor([[0, 0, 1, 1]], dtype=torch.float32)
+                scores = torch.tensor([1.0], dtype=torch.float32)
+                nms(boxes, scores, 0.5)
+            except Exception as e:
+                if "torchvision::nms does not exist" in str(e):
+                    conflicts.append("TorchVision NMS operator not available - version mismatch detected")
+
+        except ImportError:
+            pass  # PyTorch not installed
+
+        return conflicts
+
+    def check_all(self) -> Dict:
+        """Run comprehensive dependency check."""
+        results = {
+            'core': self.check_core_dependencies(),
+            'pytorch': self.check_pytorch_ecosystem(),
+            'optional': self.check_optional_dependencies(),
+            'conflicts': self.check_pytorch_conflicts(),
+            'python_version': sys.version,
+            'platform': sys.platform
+        }
+
+        self.results = results
+        return results
+
+    def print_report(self, results: Optional[Dict] = None):
+        """Print a formatted dependency report."""
+        if results is None:
+            results = self.results
+
+        print("🔍 AbstractVoice Dependency Check Report")
+        print("=" * 50)
+
+        # Python version
+        print(f"\n🐍 Python: {results['python_version']}")
+        print(f"🖥️  Platform: {results['platform']}")
+
+        # Core dependencies
+        print(f"\n📦 Core Dependencies:")
+        for package, info in results['core'].items():
+            status_icon = "✅" if info['status'] == 'installed' and info['compatible'] else "❌"
+            version_info = f"v{info['version']}" if info['version'] else "not installed"
+            print(f"  {status_icon} {package}: {version_info}")
+
+        # PyTorch ecosystem
+        print(f"\n🔥 PyTorch Ecosystem:")
+        pytorch_all_good = True
+        for package, info in results['pytorch'].items():
+            status_icon = "✅" if info['status'] == 'installed' and info['compatible'] else "❌"
+            version_info = f"v{info['version']}" if info['version'] else "not installed"
+            if info['status'] != 'installed' or not info['compatible']:
+                pytorch_all_good = False
+            print(f"  {status_icon} {package}: {version_info}")
+
+        # Conflicts
+        if results['conflicts']:
+            print(f"\n⚠️  Detected Conflicts:")
+            for conflict in results['conflicts']:
+                print(f"  ❌ {conflict}")
+            pytorch_all_good = False
+
+        if pytorch_all_good and all(info['status'] == 'installed' for info in results['pytorch'].values()):
+            print("  🎉 PyTorch ecosystem looks compatible!")
+
+        # Optional dependencies
+        print(f"\n🔧 Optional Dependencies:")
+        installed_optional = []
+        missing_optional = []
+
+        for package, info in results['optional'].items():
+            if info['status'] == 'installed':
+                status_icon = "✅" if info['compatible'] else "⚠️"
+                installed_optional.append(f"  {status_icon} {package}: v{info['version']}")
+            else:
+                missing_optional.append(f"  ⭕ {package}: not installed")
+
+        if installed_optional:
+            print("  Installed:")
+            for line in installed_optional:
+                print(line)
+
+        if missing_optional:
+            print("  Missing:")
+            for line in missing_optional:
+                print(line)
+
+        # Recommendations
+        print(f"\n💡 Recommendations:")
+
+        if not pytorch_all_good:
+            print("  🔧 Fix PyTorch conflicts with:")
+            print("     pip uninstall torch torchvision torchaudio")
+            print("     pip install abstractvoice[all]")
+
+        if not any(info['status'] == 'installed' for info in results['optional'].values()):
+            print("  📦 Install voice functionality with:")
+            print("     pip install abstractvoice[voice-full]")
+
+        print("\n" + "=" * 50)
+
+
+def check_dependencies(verbose: bool = True) -> Dict:
+    """Quick function to check all dependencies."""
+    checker = DependencyChecker(verbose=verbose)
+    results = checker.check_all()
+    if verbose:
+        checker.print_report(results)
+    return results
+
+
+if __name__ == "__main__":
+    check_dependencies()

abstractvoice/examples/cli_repl.py

@@ -235,8 +235,32 @@ class VoiceREPL(cmd.Cmd):
             if self.voice_manager:
                 self.voice_manager.speak(response_text)
                 
+        except requests.exceptions.ConnectionError as e:
+            print(f"❌ Cannot connect to Ollama API at {self.api_url}")
+            print(f"   Please check that Ollama is running and accessible")
+            print(f"   Try: ollama serve")
+            if self.debug_mode:
+                print(f"   Connection error: {e}")
+        except requests.exceptions.HTTPError as e:
+            if "404" in str(e):
+                print(f"❌ Model '{self.model}' not found on Ollama server")
+                print(f"   Available models: Try 'ollama list' to see installed models")
+                print(f"   To install a model: ollama pull {self.model}")
+            else:
+                print(f"❌ HTTP error from Ollama API: {e}")
+            if self.debug_mode:
+                print(f"   Full error: {e}")
         except Exception as e:
-            print(f"Error: {e}")
+            error_msg = str(e).lower()
+            if "model file not found" in error_msg or "no such file" in error_msg:
+                print(f"❌ Model '{self.model}' not found or not fully downloaded")
+                print(f"   Try: ollama pull {self.model}")
+                print(f"   Or use an existing model: ollama list")
+            elif "connection" in error_msg or "refused" in error_msg:
+                print(f"❌ Cannot connect to Ollama at {self.api_url}")
+                print(f"   Make sure Ollama is running: ollama serve")
+            else:
+                print(f"❌ Error: {e}")
             if self.debug_mode:
                 import traceback
                 traceback.print_exc()

abstractvoice/examples/voice_cli.py

@@ -9,9 +9,98 @@ import argparse
 import time
 from abstractvoice.examples.cli_repl import VoiceREPL
 
+def print_examples():
+    """Print available examples."""
+    print("Available examples:")
+    print("  cli       - Command-line REPL example")
+    print("  web       - Web API example")
+    print("  simple    - Simple usage example")
+    print("  check-deps - Check dependency compatibility")
+    print("\nUsage: abstractvoice <example> [--language <lang>] [args...]")
+    print("\nSupported languages: en, fr, es, de, it, ru, multilingual")
+    print("\nExamples:")
+    print("  abstractvoice cli --language fr    # French CLI")
+    print("  abstractvoice simple --language ru # Russian simple example")
+    print("  abstractvoice check-deps           # Check dependencies")
+    print("  abstractvoice                      # Direct voice mode (default)")
+
+def simple_example():
+    """Run a simple example demonstrating basic usage."""
+    from abstractvoice import VoiceManager
+    import time
+
+    print("Simple AbstractVoice Example")
+    print("============================")
+    print("This example demonstrates basic TTS and STT functionality.")
+    print("(Use --language argument to test different languages)")
+    print()
+
+    # Initialize voice manager (can be overridden with --language)
+    manager = VoiceManager(debug_mode=True)
+
+    try:
+        # TTS example
+        print("Speaking a welcome message...")
+        manager.speak("Hello! I'm a voice assistant powered by AbstractVoice. "
+                     "I can speak and listen to you.")
+
+        # Wait for speech to complete
+        while manager.is_speaking():
+            time.sleep(0.1)
+
+        print("\nNow I'll listen for 10 seconds. Say something!")
+
+        # Store transcribed text
+        transcribed_text = None
+
+        # Callback for speech recognition
+        def on_transcription(text):
+            nonlocal transcribed_text
+            print(f"\nTranscribed: {text}")
+            transcribed_text = text
+
+            # If user says stop, stop listening
+            if text.lower() == "stop":
+                return
+
+            # Otherwise respond
+            print("Responding...")
+            manager.speak(f"You said: {text}")
+
+        # Start listening
+        manager.listen(on_transcription)
+
+        # Listen for 10 seconds or until "stop" is said
+        start_time = time.time()
+        while time.time() - start_time < 10 and manager.is_listening():
+            time.sleep(0.1)
+
+        # Stop listening if still active
+        if manager.is_listening():
+            manager.stop_listening()
+            print("\nDone listening.")
+
+        # If something was transcribed, repeat it back
+        if transcribed_text and transcribed_text.lower() != "stop":
+            print("\nSaying goodbye...")
+            manager.speak("Thanks for trying AbstractVoice! Goodbye!")
+            while manager.is_speaking():
+                time.sleep(0.1)
+
+        print("\nExample complete!")
+
+    finally:
+        # Clean up
+        manager.cleanup()
+
 def parse_args():
     """Parse command line arguments."""
-    parser = argparse.ArgumentParser(description="AbstractVoice Voice Mode")
+    parser = argparse.ArgumentParser(description="AbstractVoice - Voice interactions with AI")
+
+    # Examples and special commands
+    parser.add_argument("command", nargs="?", help="Command to run: cli, web, simple, check-deps (default: voice mode)")
+
+    # Voice mode arguments
     parser.add_argument("--debug", action="store_true", help="Enable debug mode")
     parser.add_argument("--api", default="http://localhost:11434/api/chat",
                       help="LLM API URL")
@@ -35,11 +124,55 @@ def parse_args():
     return parser.parse_args()
 
 def main():
-    """Entry point for direct voice mode."""
+    """Entry point for AbstractVoice CLI."""
     try:
         # Parse command line arguments
         args = parse_args()
-        
+
+        # Handle special commands and examples
+        if args.command == "check-deps":
+            from abstractvoice.dependency_check import check_dependencies
+            try:
+                check_dependencies(verbose=True)
+            except Exception as e:
+                print(f"❌ Error running dependency check: {e}")
+                print("This might indicate a dependency issue.")
+                if args.debug:
+                    import traceback
+                    traceback.print_exc()
+            return
+        elif args.command == "cli":
+            # Import and run CLI REPL example
+            repl = VoiceREPL(
+                api_url=args.api,
+                model=args.model,
+                debug_mode=args.debug,
+                language=args.language,
+                tts_model=args.tts_model
+            )
+            # Set temperature and max_tokens
+            repl.temperature = args.temperature
+            repl.max_tokens = args.max_tokens
+            if args.system:
+                repl.system_prompt = args.system
+                repl.messages = [{"role": "system", "content": args.system}]
+            repl.cmdloop()
+            return
+        elif args.command == "web":
+            from abstractvoice.examples.web_api import main as web_main
+            web_main()
+            return
+        elif args.command == "simple":
+            simple_example()
+            return
+        elif args.command == "help" or args.command == "--help":
+            print_examples()
+            return
+        elif args.command:
+            print(f"Unknown command: {args.command}")
+            print_examples()
+            return
+
         # Show language information
         language_names = {
             'en': 'English', 'fr': 'French', 'es': 'Spanish',
@@ -90,7 +223,24 @@ def main():
     except KeyboardInterrupt:
         print("\nExiting AbstractVoice...")
     except Exception as e:
-        print(f"Application error: {e}")
+        error_msg = str(e).lower()
+        if "model file not found" in error_msg or "no such file" in error_msg:
+            print(f"❌ Model '{args.model}' not found")
+            print(f"   The model file is missing or not fully downloaded")
+            print(f"   Try: ollama pull {args.model}")
+            print(f"   Or check available models: ollama list")
+        elif "connection" in error_msg or "refused" in error_msg:
+            print(f"❌ Cannot connect to Ollama")
+            print(f"   Make sure Ollama is running: ollama serve")
+            print(f"   API URL: {args.api}")
+        elif "importerror" in error_msg or "no module" in error_msg:
+            print(f"❌ Missing dependencies")
+            print(f"   Try running: abstractvoice check-deps")
+            print(f"   Or install dependencies: pip install abstractvoice[voice-full]")
+        else:
+            print(f"❌ Application error: {e}")
+            print(f"   Try running with --debug for more details")
+
         if args.debug:
             import traceback
             traceback.print_exc()

abstractvoice/tts/tts_engine.py

@@ -24,12 +24,43 @@ def _import_tts():
         from TTS.api import TTS
         return TTS
     except ImportError as e:
-        raise ImportError(
-            "TTS functionality requires optional dependencies. Install with:\n"
-            "  pip install abstractvoice[tts]    # For TTS only\n"
-            "  pip install abstractvoice[all]    # For all features\n"
-            f"Original error: {e}"
-        ) from e
+        error_msg = str(e).lower()
+
+        # Check for specific PyTorch/TorchVision conflicts
+        if "torchvision::nms does not exist" in error_msg or "gpt2pretrainedmodel" in error_msg:
+            raise ImportError(
+                "❌ PyTorch/TorchVision version conflict detected!\n\n"
+                "This is a known compatibility issue. To fix:\n\n"
+                "1. Uninstall conflicting packages:\n"
+                "   pip uninstall torch torchvision torchaudio transformers\n\n"
+                "2. Reinstall with compatible versions:\n"
+                "   pip install abstractvoice[all]  # Installs tested compatible versions\n\n"
+                "3. Or use specific PyTorch version:\n"
+                "   pip install torch==2.3.1 torchvision==0.18.1 torchaudio==2.3.1\n"
+                "   pip install abstractvoice[voice-full]\n\n"
+                "For conda environments, consider:\n"
+                "   conda install pytorch torchvision torchaudio pytorch-cuda=11.8 -c pytorch -c nvidia\n\n"
+                f"Original error: {e}"
+            ) from e
+        elif "no module named 'tts'" in error_msg or "coqui" in error_msg:
+            raise ImportError(
+                "TTS functionality requires coqui-tts. Install with:\n"
+                "  pip install abstractvoice[tts]        # For TTS only\n"
+                "  pip install abstractvoice[voice-full] # For complete voice functionality\n"
+                "  pip install abstractvoice[all]        # For all features\n"
+                f"Original error: {e}"
+            ) from e
+        else:
+            # Generic import error
+            raise ImportError(
+                "TTS functionality requires optional dependencies. Install with:\n"
+                "  pip install abstractvoice[tts]        # For TTS only\n"
+                "  pip install abstractvoice[voice-full] # For complete voice functionality\n"
+                "  pip install abstractvoice[all]        # For all features\n\n"
+                "If you're getting PyTorch-related errors, try:\n"
+                "  pip install abstractvoice[core-tts]   # Lightweight TTS without extras\n\n"
+                f"Original error: {e}"
+            ) from e
 
 def _import_audio_deps():
     """Import audio dependencies with helpful error message if missing."""
@@ -38,14 +69,37 @@ def _import_audio_deps():
         import librosa
         return sd, librosa
     except ImportError as e:
-        if "sounddevice" in str(e) or "librosa" in str(e):
+        error_msg = str(e).lower()
+
+        if "sounddevice" in error_msg:
+            raise ImportError(
+                "Audio playback requires sounddevice. Install with:\n"
+                "  pip install abstractvoice[audio-only]  # For audio processing only\n"
+                "  pip install abstractvoice[voice-full]  # For complete voice functionality\n"
+                "  pip install abstractvoice[all]         # For all features\n\n"
+                "On some systems, you may need system audio libraries:\n"
+                "  Ubuntu/Debian: sudo apt-get install portaudio19-dev\n"
+                "  macOS: brew install portaudio\n"
+                "  Windows: Usually works out of the box\n\n"
+                f"Original error: {e}"
+            ) from e
+        elif "librosa" in error_msg:
+            raise ImportError(
+                "Audio processing requires librosa. Install with:\n"
+                "  pip install abstractvoice[tts]         # For TTS functionality\n"
+                "  pip install abstractvoice[voice-full]  # For complete voice functionality\n"
+                "  pip install abstractvoice[all]         # For all features\n\n"
+                f"Original error: {e}"
+            ) from e
+        else:
+            # Generic audio import error
             raise ImportError(
                 "Audio functionality requires optional dependencies. Install with:\n"
-                "  pip install abstractvoice[voice]  # For basic audio\n"
-                "  pip install abstractvoice[all]    # For all features\n"
+                "  pip install abstractvoice[audio-only]  # For audio processing only\n"
+                "  pip install abstractvoice[voice-full]  # For complete voice functionality\n"
+                "  pip install abstractvoice[all]         # For all features\n\n"
                 f"Original error: {e}"
             ) from e
-        raise
 
 # Suppress the PyTorch FutureWarning about torch.load
 warnings.filterwarnings(

{abstractvoice-0.2.0.dist-info → abstractvoice-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractvoice
-Version: 0.2.0
+Version: 0.3.0
 Summary: A modular Python library for voice interactions with AI systems
 Author-email: Laurent-Philippe Albou <contact@abstractcore.ai>
 License-Expression: MIT
@@ -25,10 +25,11 @@ Requires-Dist: webrtcvad>=2.0.10; extra == "voice"
 Requires-Dist: PyAudio>=0.2.13; extra == "voice"
 Requires-Dist: soundfile>=0.12.1; extra == "voice"
 Provides-Extra: tts
-Requires-Dist: coqui-tts>=0.27.0; extra == "tts"
-Requires-Dist: torch>=2.0.0; extra == "tts"
-Requires-Dist: torchaudio>=2.0.0; extra == "tts"
-Requires-Dist: librosa>=0.10.0; extra == "tts"
+Requires-Dist: coqui-tts<0.30.0,>=0.27.0; extra == "tts"
+Requires-Dist: torch<2.4.0,>=2.0.0; extra == "tts"
+Requires-Dist: torchvision<0.19.0,>=0.15.0; extra == "tts"
+Requires-Dist: torchaudio<2.4.0,>=2.0.0; extra == "tts"
+Requires-Dist: librosa<0.11.0,>=0.10.0; extra == "tts"
 Provides-Extra: stt
 Requires-Dist: openai-whisper>=20230314; extra == "stt"
 Requires-Dist: tiktoken>=0.6.0; extra == "stt"
@@ -39,10 +40,11 @@ Requires-Dist: sounddevice>=0.4.6; extra == "all"
 Requires-Dist: webrtcvad>=2.0.10; extra == "all"
 Requires-Dist: PyAudio>=0.2.13; extra == "all"
 Requires-Dist: openai-whisper>=20230314; extra == "all"
-Requires-Dist: coqui-tts>=0.27.0; extra == "all"
-Requires-Dist: torch>=2.0.0; extra == "all"
-Requires-Dist: torchaudio>=2.0.0; extra == "all"
-Requires-Dist: librosa>=0.10.0; extra == "all"
+Requires-Dist: coqui-tts<0.30.0,>=0.27.0; extra == "all"
+Requires-Dist: torch<2.4.0,>=2.0.0; extra == "all"
+Requires-Dist: torchvision<0.19.0,>=0.15.0; extra == "all"
+Requires-Dist: torchaudio<2.4.0,>=2.0.0; extra == "all"
+Requires-Dist: librosa<0.11.0,>=0.10.0; extra == "all"
 Requires-Dist: soundfile>=0.12.1; extra == "all"
 Requires-Dist: flask>=2.0.0; extra == "all"
 Requires-Dist: tiktoken>=0.6.0; extra == "all"
@@ -50,66 +52,32 @@ Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: black>=22.0.0; extra == "dev"
 Requires-Dist: flake8>=5.0.0; extra == "dev"
-Provides-Extra: languages
-Requires-Dist: sounddevice>=0.4.6; extra == "languages"
-Requires-Dist: webrtcvad>=2.0.10; extra == "languages"
-Requires-Dist: PyAudio>=0.2.13; extra == "languages"
-Requires-Dist: openai-whisper>=20230314; extra == "languages"
-Requires-Dist: coqui-tts>=0.27.0; extra == "languages"
-Requires-Dist: torch>=2.0.0; extra == "languages"
-Requires-Dist: torchaudio>=2.0.0; extra == "languages"
-Requires-Dist: librosa>=0.10.0; extra == "languages"
-Requires-Dist: soundfile>=0.12.1; extra == "languages"
-Requires-Dist: flask>=2.0.0; extra == "languages"
-Requires-Dist: tiktoken>=0.6.0; extra == "languages"
-Provides-Extra: fr
-Requires-Dist: sounddevice>=0.4.6; extra == "fr"
-Requires-Dist: webrtcvad>=2.0.10; extra == "fr"
-Requires-Dist: PyAudio>=0.2.13; extra == "fr"
-Requires-Dist: openai-whisper>=20230314; extra == "fr"
-Requires-Dist: coqui-tts>=0.27.0; extra == "fr"
-Requires-Dist: torch>=2.0.0; extra == "fr"
-Requires-Dist: torchaudio>=2.0.0; extra == "fr"
-Requires-Dist: librosa>=0.10.0; extra == "fr"
-Requires-Dist: soundfile>=0.12.1; extra == "fr"
-Requires-Dist: flask>=2.0.0; extra == "fr"
-Requires-Dist: tiktoken>=0.6.0; extra == "fr"
-Provides-Extra: es
-Requires-Dist: sounddevice>=0.4.6; extra == "es"
-Requires-Dist: webrtcvad>=2.0.10; extra == "es"
-Requires-Dist: PyAudio>=0.2.13; extra == "es"
-Requires-Dist: openai-whisper>=20230314; extra == "es"
-Requires-Dist: coqui-tts>=0.27.0; extra == "es"
-Requires-Dist: torch>=2.0.0; extra == "es"
-Requires-Dist: torchaudio>=2.0.0; extra == "es"
-Requires-Dist: librosa>=0.10.0; extra == "es"
-Requires-Dist: soundfile>=0.12.1; extra == "es"
-Requires-Dist: flask>=2.0.0; extra == "es"
-Requires-Dist: tiktoken>=0.6.0; extra == "es"
-Provides-Extra: de
-Requires-Dist: sounddevice>=0.4.6; extra == "de"
-Requires-Dist: webrtcvad>=2.0.10; extra == "de"
-Requires-Dist: PyAudio>=0.2.13; extra == "de"
-Requires-Dist: openai-whisper>=20230314; extra == "de"
-Requires-Dist: coqui-tts>=0.27.0; extra == "de"
-Requires-Dist: torch>=2.0.0; extra == "de"
-Requires-Dist: torchaudio>=2.0.0; extra == "de"
-Requires-Dist: librosa>=0.10.0; extra == "de"
-Requires-Dist: soundfile>=0.12.1; extra == "de"
-Requires-Dist: flask>=2.0.0; extra == "de"
-Requires-Dist: tiktoken>=0.6.0; extra == "de"
-Provides-Extra: it
-Requires-Dist: sounddevice>=0.4.6; extra == "it"
-Requires-Dist: webrtcvad>=2.0.10; extra == "it"
-Requires-Dist: PyAudio>=0.2.13; extra == "it"
-Requires-Dist: openai-whisper>=20230314; extra == "it"
-Requires-Dist: coqui-tts>=0.27.0; extra == "it"
-Requires-Dist: torch>=2.0.0; extra == "it"
-Requires-Dist: torchaudio>=2.0.0; extra == "it"
-Requires-Dist: librosa>=0.10.0; extra == "it"
-Requires-Dist: soundfile>=0.12.1; extra == "it"
-Requires-Dist: flask>=2.0.0; extra == "it"
-Requires-Dist: tiktoken>=0.6.0; extra == "it"
+Provides-Extra: voice-full
+Requires-Dist: sounddevice>=0.4.6; extra == "voice-full"
+Requires-Dist: webrtcvad>=2.0.10; extra == "voice-full"
+Requires-Dist: PyAudio>=0.2.13; extra == "voice-full"
+Requires-Dist: openai-whisper>=20230314; extra == "voice-full"
+Requires-Dist: coqui-tts<0.30.0,>=0.27.0; extra == "voice-full"
+Requires-Dist: torch<2.4.0,>=2.0.0; extra == "voice-full"
+Requires-Dist: torchvision<0.19.0,>=0.15.0; extra == "voice-full"
+Requires-Dist: torchaudio<2.4.0,>=2.0.0; extra == "voice-full"
+Requires-Dist: librosa<0.11.0,>=0.10.0; extra == "voice-full"
+Requires-Dist: soundfile>=0.12.1; extra == "voice-full"
+Requires-Dist: tiktoken>=0.6.0; extra == "voice-full"
+Provides-Extra: core-tts
+Requires-Dist: coqui-tts<0.30.0,>=0.27.0; extra == "core-tts"
+Requires-Dist: torch<2.4.0,>=2.0.0; extra == "core-tts"
+Requires-Dist: torchvision<0.19.0,>=0.15.0; extra == "core-tts"
+Requires-Dist: torchaudio<2.4.0,>=2.0.0; extra == "core-tts"
+Requires-Dist: librosa<0.11.0,>=0.10.0; extra == "core-tts"
+Provides-Extra: core-stt
+Requires-Dist: openai-whisper>=20230314; extra == "core-stt"
+Requires-Dist: tiktoken>=0.6.0; extra == "core-stt"
+Provides-Extra: audio-only
+Requires-Dist: sounddevice>=0.4.6; extra == "audio-only"
+Requires-Dist: webrtcvad>=2.0.10; extra == "audio-only"
+Requires-Dist: PyAudio>=0.2.13; extra == "audio-only"
+Requires-Dist: soundfile>=0.12.1; extra == "audio-only"
 Dynamic: license-file
 
 # AbstractVoice
@@ -396,14 +364,40 @@ abstractvoice --debug --whisper base --model gemma3:latest --api http://localhos
   - **Note**: This creates a "TTS-only" mode where you type and the AI speaks back
 - `--system <prompt>` - Custom system prompt
 
+### 🎯 Complete CLI Interface (v0.3.0+)
+
+AbstractVoice provides a unified command interface for all functionality:
+
+```bash
+# Voice mode (default)
+abstractvoice                      # Interactive voice mode with AI
+abstractvoice --model cogito:3b    # With custom Ollama model
+abstractvoice --language fr        # French voice mode
+
+# Examples and utilities
+abstractvoice cli                  # CLI REPL for text interaction
+abstractvoice web                  # Web API server
+abstractvoice simple               # Simple TTS/STT demonstration
+abstractvoice check-deps           # Check dependency compatibility
+abstractvoice help                 # Show available commands
+
+# Get help
+abstractvoice --help               # Complete help with all options
+```
+
+**All functionality through one command!** No more confusion between different entry points.
+
 ### Command-Line REPL
 
 ```bash
 # Run the CLI example (TTS ON, STT OFF)
-abstractvoice-cli cli
+abstractvoice cli
 
 # With debug mode
-abstractvoice-cli cli --debug
+abstractvoice cli --debug
+
+# With specific language
+abstractvoice cli --language fr
 ```
 
 #### REPL Commands
@@ -455,17 +449,17 @@ All commands must start with `/` except `stop`:
 
 ```bash
 # Run the web API example
-abstractvoice-cli web
+abstractvoice web
 
 # With different host and port
-abstractvoice-cli web --host 0.0.0.0 --port 8000
+abstractvoice web --host 0.0.0.0 --port 8000
 ```
 
 You can also run a simplified version that doesn't load the full models:
 
 ```bash
 # Run the web API with simulation mode
-abstractvoice-cli web --simulate
+abstractvoice web --simulate
 ```
 
 #### Troubleshooting Web API
@@ -493,7 +487,7 @@ If you encounter issues with the web API:
 
 ```bash
 # Run the simple example
-abstractvoice-cli simple
+abstractvoice simple
 ```
 
 ## Documentation

{abstractvoice-0.2.0.dist-info → abstractvoice-0.3.0.dist-info}/RECORD

@@ -1,20 +1,21 @@
 abstractvoice/__init__.py,sha256=6GWG6ruCOQ73dOK1-lGB4F8fvjoAtsAP8fIoYCnVuZk,817
-abstractvoice/__main__.py,sha256=RQCoQy-UrYp-f5K2cl6PTXpaJz3Rk0hSOvCWCf3Ql18,4230
+abstractvoice/__main__.py,sha256=e6jhoONg3uwwPUCdnr68bSRTT1RrpWy2DrOJ6ozMJVc,4775
+abstractvoice/dependency_check.py,sha256=BUUADz4un4_FCZzNpgwk1qpJ6yqVi5Pvjfd3JLS8hAI,10045
 abstractvoice/recognition.py,sha256=4KtDUDFixEYuBUMDH2fWaD9csKlwA9tqXkMAkyQMSMo,11259
 abstractvoice/voice_manager.py,sha256=WYuN949pzf4pw8SE3g40OQZNC1CbgUZ5SzvpAGAIfPI,29995
 abstractvoice/examples/__init__.py,sha256=94vpKJDlfOrEBIUETg-57Q5Z7fYDidg6v4UzV7V_lZA,60
-abstractvoice/examples/cli_repl.py,sha256=uRFqUOVDP6RXrMquB_rQ1_fxdyLn_UHwuiu30XHbYwE,41250
-abstractvoice/examples/voice_cli.py,sha256=mhiO7i0AooPWPZD-K6O-wQUvMFbRFED-dlGNUjDvsUE,3962
+abstractvoice/examples/cli_repl.py,sha256=39KO2zbQCG3bkuzrMEp1txLherw2rU4aGG2KTUHBYW0,42636
+abstractvoice/examples/voice_cli.py,sha256=oliUPUZUPR6HaVaOtn-vAM-Loq3PDqkP34w-X3xxzbY,9702
 abstractvoice/examples/web_api.py,sha256=0g5LKJpl7fZepPQJL25AcdaevV-xv34VqqyWGYYchPk,6376
 abstractvoice/stt/__init__.py,sha256=PFc6la3tTkxT4TJYwb0PnMIahM_hFtU4pNQdeKmbooo,120
 abstractvoice/stt/transcriber.py,sha256=GdaH1OsCHu4Vu9rUsQlzH6X9bfcnoiK5tGz1AW_uj6Q,5481
 abstractvoice/tts/__init__.py,sha256=WgJrxqdc_qaRyfFt1jbgMQD9S757jYuBpDzMRB02TFs,122
-abstractvoice/tts/tts_engine.py,sha256=eMhOxMdqH7V29TLf-7B44aoafKfRDd3zT2lpSZkvAA0,41692
+abstractvoice/tts/tts_engine.py,sha256=9CZAZITZ_VNZs0grwsqWIFj3aUsHvrWeFVV66lH_Bf8,44926
 abstractvoice/vad/__init__.py,sha256=RIIbFw25jNHgel06E4VvTWJnXjwjeFZ98m1Vx9hVjuo,119
 abstractvoice/vad/voice_detector.py,sha256=ghrhpDFlIR5TsMB2gpigXY6t5c_1yZ7vEX1imAMgWjc,3166
-abstractvoice-0.2.0.dist-info/licenses/LICENSE,sha256=TiDPM5WcFRQPoC5e46jGMeMppZ-eu0eFx_HytjE49bk,1105
-abstractvoice-0.2.0.dist-info/METADATA,sha256=uxKWbHnTylSvI0CFMq6IUjY6MUAjGIGPVf8o9KEjwqY,38738
-abstractvoice-0.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-abstractvoice-0.2.0.dist-info/entry_points.txt,sha256=rL63lqtLrbd7w_hGsR_w9Mr5baq4p3Mzwn4_UJqR_nI,120
-abstractvoice-0.2.0.dist-info/top_level.txt,sha256=a1qyxqgF1O8cJtPKpcJuImGZ_uXqPNghbLZ9gp-UiOo,14
-abstractvoice-0.2.0.dist-info/RECORD,,
+abstractvoice-0.3.0.dist-info/licenses/LICENSE,sha256=TiDPM5WcFRQPoC5e46jGMeMppZ-eu0eFx_HytjE49bk,1105
+abstractvoice-0.3.0.dist-info/METADATA,sha256=_XLernZJC91kjzhBMIecBMN4bWcd2AerbPZ8rOmwFIc,38420
+abstractvoice-0.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+abstractvoice-0.3.0.dist-info/entry_points.txt,sha256=3bDX2dNOGvrsTx1wZ_o_hVgmM_a2zbcHc1ZkL154rN4,72
+abstractvoice-0.3.0.dist-info/top_level.txt,sha256=a1qyxqgF1O8cJtPKpcJuImGZ_uXqPNghbLZ9gp-UiOo,14
+abstractvoice-0.3.0.dist-info/RECORD,,

{abstractvoice-0.2.0.dist-info → abstractvoice-0.3.0.dist-info}/entry_points.txt

@@ -1,3 +1,2 @@
 [console_scripts]
 abstractvoice = abstractvoice.examples.voice_cli:main
-abstractvoice-cli = abstractvoice.__main__:main