abstractvoice 0.1.0__tar.gz → 0.2.0__tar.gz

{abstractvoice-0.1.0 → abstractvoice-0.2.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Laurent-Philippe Albou (lpalbou@gmail.com)
+Copyright (c) 2025 Laurent-Philippe Albou (contact@abstractcore.ai)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{abstractvoice-0.1.0/abstractvoice.egg-info → abstractvoice-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractvoice
-Version: 0.1.0
+Version: 0.2.0
 Summary: A modular Python library for voice interactions with AI systems
 Author-email: Laurent-Philippe Albou <contact@abstractcore.ai>
 License-Expression: MIT
@@ -18,31 +18,108 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: numpy>=1.24.0
-Requires-Dist: sounddevice>=0.4.6
-Requires-Dist: webrtcvad>=2.0.10
-Requires-Dist: PyAudio>=0.2.13
-Requires-Dist: openai-whisper>=20230314
-Requires-Dist: coqui-tts>=0.27.0
-Requires-Dist: torch>=2.0.0
-Requires-Dist: torchaudio>=2.0.0
-Requires-Dist: librosa>=0.10.0
-Requires-Dist: soundfile>=0.12.1
 Requires-Dist: requests>=2.31.0
-Requires-Dist: flask>=2.0.0
-Requires-Dist: tiktoken>=0.6.0
+Provides-Extra: voice
+Requires-Dist: sounddevice>=0.4.6; extra == "voice"
+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"
+Provides-Extra: stt
+Requires-Dist: openai-whisper>=20230314; extra == "stt"
+Requires-Dist: tiktoken>=0.6.0; extra == "stt"
+Provides-Extra: web
+Requires-Dist: flask>=2.0.0; extra == "web"
+Provides-Extra: all
+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: soundfile>=0.12.1; extra == "all"
+Requires-Dist: flask>=2.0.0; extra == "all"
+Requires-Dist: tiktoken>=0.6.0; extra == "all"
 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"
 Dynamic: license-file
 
 # AbstractVoice
 
 [![PyPI version](https://img.shields.io/pypi/v/abstractvoice.svg)](https://pypi.org/project/abstractvoice/)
 [![Python Version](https://img.shields.io/pypi/pyversions/abstractvoice)](https://pypi.org/project/abstractvoice/)
-[![License](https://img.shields.io/pypi/l/abstractvoice)](https://github.com/lpalbou/abstractvoice/blob/main/LICENSE)
+[![license](https://img.shields.io/github/license/lpalbou/AbstractVoice)](https://github.com/lpalbou/abstractvoice/blob/main/LICENSE)
 [![GitHub stars](https://img.shields.io/github/stars/lpalbou/abstractvoice?style=social)](https://github.com/lpalbou/abstractvoice/stargazers)
 
+
 A modular Python library for voice interactions with AI systems, providing text-to-speech (TTS) and speech-to-text (STT) capabilities with interrupt handling.
 
 While we provide CLI and WEB examples, AbstractVoice is designed to be integrated in other projects.
@@ -62,73 +139,174 @@ While we provide CLI and WEB examples, AbstractVoice is designed to be integrate
 - **Interrupt Handling**: Stop TTS by speaking or using stop commands
 - **Modular Design**: Easily integrate with any text generation system
 
+Note : *the LLM access is rudimentary and abstractvoice is provided more as an example and demonstrator. A better integration is to use the functionalities of this library and use them directly in combination with [AbstractCore](https://github.com/lpalbou/AbstractCore)*.
+
 ## Installation
 
-### Prerequisites
+AbstractVoice is designed to **work everywhere, out of the box** with automatic quality upgrades.
+
+### 🚀 Quick Start (Recommended)
+
+```bash
+# One command installation - works on all systems
+pip install abstractvoice[all]
 
-- Python 3.8+ (3.11+ recommended)
-- PortAudio for audio input/output
-- **Recommended**: espeak-ng for best voice quality (VITS model)
+# Verify it works
+python -c "from abstractvoice import VoiceManager; print('✅ Ready to go!')"
+```
 
-### Installing espeak-ng (Recommended for Best Quality)
+**That's it!** AbstractVoice automatically:
+- ✅ **Works everywhere** - Uses reliable models that run on any system
+- ✅ **Auto-upgrades quality** - Detects when better models are available
+- ✅ **No system dependencies required** - Pure Python installation
+- ✅ **Optional quality boost** - Install `espeak-ng` for premium voices
 
-AbstractVoice will work without espeak-ng, but voice quality will be significantly better with it:
+### Installation Options
 
-**macOS:**
 ```bash
-brew install espeak-ng
+# Minimal (just 2 dependencies)
+pip install abstractvoice
+
+# Add features as needed
+pip install abstractvoice[tts]      # Text-to-speech
+pip install abstractvoice[stt]      # Speech-to-text
+pip install abstractvoice[all]      # Everything (recommended)
+
+# Language-specific
+pip install abstractvoice[fr]       # French with all features
+pip install abstractvoice[de]       # German with all features
 ```
 
-**Linux (Ubuntu/Debian):**
+### Optional Quality Upgrade
+
+For the **absolute best voice quality**, install espeak-ng:
+
 ```bash
+# macOS
+brew install espeak-ng
+
+# Linux
 sudo apt-get install espeak-ng
+
+# Windows
+conda install espeak-ng
 ```
 
-**Linux (Fedora/RHEL):**
-```bash
-sudo yum install espeak-ng
+AbstractVoice automatically detects espeak-ng and upgrades to premium quality voices when available.
+
+## Quick Start
+
+### Basic Usage (Minimal Installation)
+
+```python
+# First install with minimal dependencies
+# pip install abstractvoice
+
+from abstractvoice import VoiceManager
+
+# This will show a helpful error message with installation instructions
+try:
+    vm = VoiceManager()
+except ImportError as e:
+    print(e)  # Shows: "TTS functionality requires optional dependencies..."
+    # Follow the instructions to install: pip install abstractvoice[all]
 ```
 
-**Windows:**
-```bash
-# Option 1: Using Conda
-conda install -c conda-forge espeak-ng
+### Full Usage Example
 
-# Option 2: Using Chocolatey
-choco install espeak-ng
+```python
+# After installing with: pip install abstractvoice[all]
 
-# Option 3: Download installer from https://github.com/espeak-ng/espeak-ng/releases
+from abstractvoice import VoiceManager
+
+# Initialize voice manager
+vm = VoiceManager(language='en', debug_mode=True)
+
+# Text-to-speech
+vm.speak("Hello! I can speak text and listen for responses.")
+
+# Speech-to-text with callbacks
+def on_transcription(text):
+    print(f"You said: {text}")
+    # Process the transcription
+    vm.speak(f"I heard you say: {text}")
+
+def on_stop():
+    print("Stopping voice interaction")
+
+# Start listening
+vm.listen(on_transcription, on_stop)
+
+# The voice manager will automatically pause listening when speaking
+# and resume when done to prevent feedback loops
 ```
 
-**Without espeak-ng:** AbstractVoice will automatically fall back to a simpler TTS model (fast_pitch) that works everywhere but has lower voice quality.
+## Additional Examples
 
-### Basic Installation
+### Language-Specific Usage
 
-```bash
-# Install from PyPI
-pip install abstractvoice
+```python
+# French voice
+vm_fr = VoiceManager(language='fr')
+vm_fr.speak("Bonjour! Je peux parler français.")
 
-# Or clone the repository
-git clone https://github.com/lpalbou/abstractvoice.git
-cd abstractvoice
-pip install -e .
+# Spanish voice
+vm_es = VoiceManager(language='es')
+vm_es.speak("¡Hola! Puedo hablar español.")
+
+# Dynamic language switching
+vm.set_language('fr')  # Switch to French
+vm.set_language('en')  # Switch back to English
 ```
 
-### Development Installation
+### Advanced Configuration
 
-```bash
-# Install with development dependencies
-pip install "abstractvoice[dev]"
+```python
+from abstractvoice import VoiceManager
+
+# Custom TTS model selection
+vm = VoiceManager(
+    language='en',
+    tts_model='tts_models/en/ljspeech/fast_pitch',  # Specific model
+    whisper_model='base',  # Larger Whisper model for better accuracy
+    debug_mode=True
+)
+
+# Speed control
+vm.set_speed(1.5)  # 1.5x speed
+vm.speak("This text will be spoken faster.")
+
+# Model switching at runtime
+vm.set_tts_model('tts_models/en/ljspeech/vits')  # Switch to VITS
+vm.set_whisper('small')  # Switch to larger Whisper model
 ```
 
-### From Requirements File
+### Error Handling and Graceful Degradation
 
-```bash
-# Install all dependencies including the package
-pip install -r requirements.txt
+AbstractVoice is designed to provide helpful error messages and fallback gracefully:
+
+```python
+# If you install just the basic package
+# pip install abstractvoice
+
+from abstractvoice import VoiceManager  # This works fine
+
+try:
+    vm = VoiceManager()  # This will fail with helpful message
+except ImportError as e:
+    print(e)
+    # Output: "TTS functionality requires optional dependencies. Install with:
+    #          pip install abstractvoice[tts]    # For TTS only
+    #          pip install abstractvoice[all]    # For all features"
+
+# Missing espeak-ng automatically falls back to compatible models
+# Missing dependencies show clear installation instructions
+# All errors are graceful with helpful guidance
 ```
 
-## Quick Start
+## CLI and Web Examples
+
+AbstractVoice includes example applications to demonstrate its capabilities:
 
 ### Using AbstractVoice from the Command Line
 

abstractvoice-0.1.0/PKG-INFO → abstractvoice-0.2.0/README.md

@@ -1,48 +1,11 @@
-Metadata-Version: 2.4
-Name: abstractvoice
-Version: 0.1.0
-Summary: A modular Python library for voice interactions with AI systems
-Author-email: Laurent-Philippe Albou <contact@abstractcore.ai>
-License-Expression: MIT
-Project-URL: Repository, https://github.com/lpalbou/abstractvoice
-Project-URL: Documentation, https://github.com/lpalbou/abstractvoice#readme
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: numpy>=1.24.0
-Requires-Dist: sounddevice>=0.4.6
-Requires-Dist: webrtcvad>=2.0.10
-Requires-Dist: PyAudio>=0.2.13
-Requires-Dist: openai-whisper>=20230314
-Requires-Dist: coqui-tts>=0.27.0
-Requires-Dist: torch>=2.0.0
-Requires-Dist: torchaudio>=2.0.0
-Requires-Dist: librosa>=0.10.0
-Requires-Dist: soundfile>=0.12.1
-Requires-Dist: requests>=2.31.0
-Requires-Dist: flask>=2.0.0
-Requires-Dist: tiktoken>=0.6.0
-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"
-Dynamic: license-file
-
 # AbstractVoice
 
 [![PyPI version](https://img.shields.io/pypi/v/abstractvoice.svg)](https://pypi.org/project/abstractvoice/)
 [![Python Version](https://img.shields.io/pypi/pyversions/abstractvoice)](https://pypi.org/project/abstractvoice/)
-[![License](https://img.shields.io/pypi/l/abstractvoice)](https://github.com/lpalbou/abstractvoice/blob/main/LICENSE)
+[![license](https://img.shields.io/github/license/lpalbou/AbstractVoice)](https://github.com/lpalbou/abstractvoice/blob/main/LICENSE)
 [![GitHub stars](https://img.shields.io/github/stars/lpalbou/abstractvoice?style=social)](https://github.com/lpalbou/abstractvoice/stargazers)
 
+
 A modular Python library for voice interactions with AI systems, providing text-to-speech (TTS) and speech-to-text (STT) capabilities with interrupt handling.
 
 While we provide CLI and WEB examples, AbstractVoice is designed to be integrated in other projects.
@@ -62,73 +25,174 @@ While we provide CLI and WEB examples, AbstractVoice is designed to be integrate
 - **Interrupt Handling**: Stop TTS by speaking or using stop commands
 - **Modular Design**: Easily integrate with any text generation system
 
+Note : *the LLM access is rudimentary and abstractvoice is provided more as an example and demonstrator. A better integration is to use the functionalities of this library and use them directly in combination with [AbstractCore](https://github.com/lpalbou/AbstractCore)*.
+
 ## Installation
 
-### Prerequisites
+AbstractVoice is designed to **work everywhere, out of the box** with automatic quality upgrades.
+
+### 🚀 Quick Start (Recommended)
 
-- Python 3.8+ (3.11+ recommended)
-- PortAudio for audio input/output
-- **Recommended**: espeak-ng for best voice quality (VITS model)
+```bash
+# One command installation - works on all systems
+pip install abstractvoice[all]
+
+# Verify it works
+python -c "from abstractvoice import VoiceManager; print('✅ Ready to go!')"
+```
 
-### Installing espeak-ng (Recommended for Best Quality)
+**That's it!** AbstractVoice automatically:
+- ✅ **Works everywhere** - Uses reliable models that run on any system
+- ✅ **Auto-upgrades quality** - Detects when better models are available
+- ✅ **No system dependencies required** - Pure Python installation
+- ✅ **Optional quality boost** - Install `espeak-ng` for premium voices
 
-AbstractVoice will work without espeak-ng, but voice quality will be significantly better with it:
+### Installation Options
 
-**macOS:**
 ```bash
-brew install espeak-ng
+# Minimal (just 2 dependencies)
+pip install abstractvoice
+
+# Add features as needed
+pip install abstractvoice[tts]      # Text-to-speech
+pip install abstractvoice[stt]      # Speech-to-text
+pip install abstractvoice[all]      # Everything (recommended)
+
+# Language-specific
+pip install abstractvoice[fr]       # French with all features
+pip install abstractvoice[de]       # German with all features
 ```
 
-**Linux (Ubuntu/Debian):**
+### Optional Quality Upgrade
+
+For the **absolute best voice quality**, install espeak-ng:
+
 ```bash
+# macOS
+brew install espeak-ng
+
+# Linux
 sudo apt-get install espeak-ng
+
+# Windows
+conda install espeak-ng
 ```
 
-**Linux (Fedora/RHEL):**
-```bash
-sudo yum install espeak-ng
+AbstractVoice automatically detects espeak-ng and upgrades to premium quality voices when available.
+
+## Quick Start
+
+### Basic Usage (Minimal Installation)
+
+```python
+# First install with minimal dependencies
+# pip install abstractvoice
+
+from abstractvoice import VoiceManager
+
+# This will show a helpful error message with installation instructions
+try:
+    vm = VoiceManager()
+except ImportError as e:
+    print(e)  # Shows: "TTS functionality requires optional dependencies..."
+    # Follow the instructions to install: pip install abstractvoice[all]
 ```
 
-**Windows:**
-```bash
-# Option 1: Using Conda
-conda install -c conda-forge espeak-ng
+### Full Usage Example
+
+```python
+# After installing with: pip install abstractvoice[all]
+
+from abstractvoice import VoiceManager
+
+# Initialize voice manager
+vm = VoiceManager(language='en', debug_mode=True)
+
+# Text-to-speech
+vm.speak("Hello! I can speak text and listen for responses.")
+
+# Speech-to-text with callbacks
+def on_transcription(text):
+    print(f"You said: {text}")
+    # Process the transcription
+    vm.speak(f"I heard you say: {text}")
+
+def on_stop():
+    print("Stopping voice interaction")
 
-# Option 2: Using Chocolatey
-choco install espeak-ng
+# Start listening
+vm.listen(on_transcription, on_stop)
 
-# Option 3: Download installer from https://github.com/espeak-ng/espeak-ng/releases
+# The voice manager will automatically pause listening when speaking
+# and resume when done to prevent feedback loops
 ```
 
-**Without espeak-ng:** AbstractVoice will automatically fall back to a simpler TTS model (fast_pitch) that works everywhere but has lower voice quality.
+## Additional Examples
 
-### Basic Installation
+### Language-Specific Usage
 
-```bash
-# Install from PyPI
-pip install abstractvoice
+```python
+# French voice
+vm_fr = VoiceManager(language='fr')
+vm_fr.speak("Bonjour! Je peux parler français.")
+
+# Spanish voice
+vm_es = VoiceManager(language='es')
+vm_es.speak("¡Hola! Puedo hablar español.")
 
-# Or clone the repository
-git clone https://github.com/lpalbou/abstractvoice.git
-cd abstractvoice
-pip install -e .
+# Dynamic language switching
+vm.set_language('fr')  # Switch to French
+vm.set_language('en')  # Switch back to English
 ```
 
-### Development Installation
+### Advanced Configuration
 
-```bash
-# Install with development dependencies
-pip install "abstractvoice[dev]"
+```python
+from abstractvoice import VoiceManager
+
+# Custom TTS model selection
+vm = VoiceManager(
+    language='en',
+    tts_model='tts_models/en/ljspeech/fast_pitch',  # Specific model
+    whisper_model='base',  # Larger Whisper model for better accuracy
+    debug_mode=True
+)
+
+# Speed control
+vm.set_speed(1.5)  # 1.5x speed
+vm.speak("This text will be spoken faster.")
+
+# Model switching at runtime
+vm.set_tts_model('tts_models/en/ljspeech/vits')  # Switch to VITS
+vm.set_whisper('small')  # Switch to larger Whisper model
 ```
 
-### From Requirements File
+### Error Handling and Graceful Degradation
 
-```bash
-# Install all dependencies including the package
-pip install -r requirements.txt
+AbstractVoice is designed to provide helpful error messages and fallback gracefully:
+
+```python
+# If you install just the basic package
+# pip install abstractvoice
+
+from abstractvoice import VoiceManager  # This works fine
+
+try:
+    vm = VoiceManager()  # This will fail with helpful message
+except ImportError as e:
+    print(e)
+    # Output: "TTS functionality requires optional dependencies. Install with:
+    #          pip install abstractvoice[tts]    # For TTS only
+    #          pip install abstractvoice[all]    # For all features"
+
+# Missing espeak-ng automatically falls back to compatible models
+# Missing dependencies show clear installation instructions
+# All errors are graceful with helpful guidance
 ```
 
-## Quick Start
+## CLI and Web Examples
+
+AbstractVoice includes example applications to demonstrate its capabilities:
 
 ### Using AbstractVoice from the Command Line
 
@@ -1129,4 +1193,4 @@ AbstractVoice is licensed under the [MIT License](LICENSE).
 
 This project depends on several open-source libraries and models, each with their own licenses. Please see [ACKNOWLEDGMENTS.md](ACKNOWLEDGMENTS.md) for a detailed list of dependencies and their respective licenses.
 
-Some dependencies, particularly certain TTS models, may have non-commercial use restrictions. If you plan to use AbstractVoice in a commercial application, please ensure you are using models that permit commercial use or obtain appropriate licenses. 
+Some dependencies, particularly certain TTS models, may have non-commercial use restrictions. If you plan to use AbstractVoice in a commercial application, please ensure you are using models that permit commercial use or obtain appropriate licenses. 

{abstractvoice-0.1.0 → abstractvoice-0.2.0}/abstractvoice/__main__.py

@@ -15,20 +15,25 @@ def print_examples():
     print("  cli       - Command-line REPL example")
     print("  web       - Web API example")
     print("  simple    - Simple usage example")
-    print("\nUsage: python -m abstractvoice <example> [args...]")
+    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")
 
 
 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
+
+    # Initialize voice manager (can be overridden with --language)
     manager = VoiceManager(debug_mode=True)
     
     try:
@@ -91,17 +96,22 @@ def main():
     """Main entry point."""
     parser = argparse.ArgumentParser(description="AbstractVoice examples")
     parser.add_argument("example", nargs="?", help="Example to run (cli, web, simple)")
-    
-    # Parse just the first argument
+    parser.add_argument("--language", "--lang", default="en",
+                      choices=["en", "fr", "es", "de", "it", "ru", "multilingual"],
+                      help="Voice language for examples")
+
+    # Parse just the first argument and language
     args, remaining = parser.parse_known_args()
-    
+
     if not args.example:
         print_examples()
         return
-    
-    # Set remaining args as sys.argv for the examples
+
+    # Set remaining args as sys.argv for the examples, including language
+    if args.language != "en":
+        remaining = ["--language", args.language] + remaining
     sys.argv = [sys.argv[0]] + remaining
-    
+
     if args.example == "cli":
         from abstractvoice.examples.cli_repl import main
         main()