abstractvoice 0.2.1__tar.gz → 0.3.0__tar.gz

{abstractvoice-0.2.1 → abstractvoice-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractvoice
-Version: 0.2.1
+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
@@ -364,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
@@ -423,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
@@ -461,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.1 → abstractvoice-0.3.0}/README.md

@@ -282,14 +282,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
@@ -341,17 +367,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
@@ -379,7 +405,7 @@ If you encounter issues with the web API:
 
 ```bash
 # Run the simple example
-abstractvoice-cli simple
+abstractvoice simple
 ```
 
 ## Documentation

{abstractvoice-0.2.1 → abstractvoice-0.3.0}/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-0.3.0/abstractvoice/examples/voice_cli.py

@@ -0,0 +1,249 @@
+#!/usr/bin/env python3
+"""
+AbstractVoice voice mode CLI launcher.
+
+This module provides a direct entry point to start AbstractVoice in voice mode.
+"""
+
+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 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")
+    parser.add_argument("--model", default="granite3.3:2b",
+                      help="LLM model name")
+    parser.add_argument("--whisper", default="tiny",
+                      help="Whisper model to use (tiny, base, small, medium, large)")
+    parser.add_argument("--no-listening", action="store_true",
+                      help="Disable speech-to-text (listening), TTS still works")
+    parser.add_argument("--system",
+                      help="Custom system prompt")
+    parser.add_argument("--temperature", type=float, default=0.4,
+                      help="Set temperature (0.0-2.0) for the LLM")
+    parser.add_argument("--max-tokens", type=int, default=4096,
+                      help="Set maximum tokens for the LLM response")
+    parser.add_argument("--language", "--lang", default="en",
+                      choices=["en", "fr", "es", "de", "it", "ru", "multilingual"],
+                      help="Voice language (en=English, fr=French, es=Spanish, de=German, it=Italian, ru=Russian, multilingual=All)")
+    parser.add_argument("--tts-model",
+                      help="Specific TTS model to use (overrides language default)")
+    return parser.parse_args()
+
+def main():
+    """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',
+            'de': 'German', 'it': 'Italian', 'ru': 'Russian',
+            'multilingual': 'Multilingual'
+        }
+        lang_name = language_names.get(args.language, args.language)
+        print(f"Starting AbstractVoice voice interface ({lang_name})...")
+        
+        # Initialize REPL with language support
+        repl = VoiceREPL(
+            api_url=args.api,
+            model=args.model,
+            debug_mode=args.debug,
+            language=args.language,
+            tts_model=args.tts_model
+        )
+        
+        # Set custom system prompt if provided
+        if args.system:
+            repl.system_prompt = args.system
+            repl.messages = [{"role": "system", "content": args.system}]
+            if args.debug:
+                print(f"System prompt set to: {args.system}")
+        
+        # Set temperature and max_tokens
+        repl.temperature = args.temperature
+        repl.max_tokens = args.max_tokens
+        if args.debug:
+            print(f"Temperature: {args.temperature}")
+            print(f"Max tokens: {args.max_tokens}")
+        
+        # Change Whisper model if specified
+        if args.whisper and args.whisper != "tiny":
+            if repl.voice_manager.set_whisper(args.whisper):
+                if args.debug:
+                    print(f"Using Whisper model: {args.whisper}")
+        
+        # Start in voice mode automatically unless --no-listening is specified
+        if not args.no_listening:
+            print("Activating voice mode. Say 'stop' to exit voice mode.")
+            # Use the existing voice mode method
+            repl.do_voice("on")
+        
+        # Start the REPL
+        repl.cmdloop()
+        
+    except KeyboardInterrupt:
+        print("\nExiting AbstractVoice...")
+    except Exception as 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()
+
+if __name__ == "__main__":
+    main() 

{abstractvoice-0.2.1 → abstractvoice-0.3.0}/abstractvoice.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractvoice
-Version: 0.2.1
+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
@@ -364,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
@@ -423,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
@@ -461,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.1 → abstractvoice-0.3.0}/abstractvoice.egg-info/entry_points.txt

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

{abstractvoice-0.2.1 → abstractvoice-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "abstractvoice"
-version = "0.2.1"
+version = "0.3.0"
 description = "A modular Python library for voice interactions with AI systems"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -123,5 +123,4 @@ Repository = "https://github.com/lpalbou/abstractvoice"
 Documentation = "https://github.com/lpalbou/abstractvoice#readme"
 
 [project.scripts]
-abstractvoice = "abstractvoice.examples.voice_cli:main"
-abstractvoice-cli = "abstractvoice.__main__:main" 
+abstractvoice = "abstractvoice.examples.voice_cli:main" 

abstractvoice-0.2.1/abstractvoice/examples/voice_cli.py

@@ -1,99 +0,0 @@
-#!/usr/bin/env python3
-"""
-AbstractVoice voice mode CLI launcher.
-
-This module provides a direct entry point to start AbstractVoice in voice mode.
-"""
-
-import argparse
-import time
-from abstractvoice.examples.cli_repl import VoiceREPL
-
-def parse_args():
-    """Parse command line arguments."""
-    parser = argparse.ArgumentParser(description="AbstractVoice Voice Mode")
-    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")
-    parser.add_argument("--model", default="granite3.3:2b",
-                      help="LLM model name")
-    parser.add_argument("--whisper", default="tiny",
-                      help="Whisper model to use (tiny, base, small, medium, large)")
-    parser.add_argument("--no-listening", action="store_true",
-                      help="Disable speech-to-text (listening), TTS still works")
-    parser.add_argument("--system",
-                      help="Custom system prompt")
-    parser.add_argument("--temperature", type=float, default=0.4,
-                      help="Set temperature (0.0-2.0) for the LLM")
-    parser.add_argument("--max-tokens", type=int, default=4096,
-                      help="Set maximum tokens for the LLM response")
-    parser.add_argument("--language", "--lang", default="en",
-                      choices=["en", "fr", "es", "de", "it", "ru", "multilingual"],
-                      help="Voice language (en=English, fr=French, es=Spanish, de=German, it=Italian, ru=Russian, multilingual=All)")
-    parser.add_argument("--tts-model",
-                      help="Specific TTS model to use (overrides language default)")
-    return parser.parse_args()
-
-def main():
-    """Entry point for direct voice mode."""
-    try:
-        # Parse command line arguments
-        args = parse_args()
-        
-        # Show language information
-        language_names = {
-            'en': 'English', 'fr': 'French', 'es': 'Spanish',
-            'de': 'German', 'it': 'Italian', 'ru': 'Russian',
-            'multilingual': 'Multilingual'
-        }
-        lang_name = language_names.get(args.language, args.language)
-        print(f"Starting AbstractVoice voice interface ({lang_name})...")
-        
-        # Initialize REPL with language support
-        repl = VoiceREPL(
-            api_url=args.api,
-            model=args.model,
-            debug_mode=args.debug,
-            language=args.language,
-            tts_model=args.tts_model
-        )
-        
-        # Set custom system prompt if provided
-        if args.system:
-            repl.system_prompt = args.system
-            repl.messages = [{"role": "system", "content": args.system}]
-            if args.debug:
-                print(f"System prompt set to: {args.system}")
-        
-        # Set temperature and max_tokens
-        repl.temperature = args.temperature
-        repl.max_tokens = args.max_tokens
-        if args.debug:
-            print(f"Temperature: {args.temperature}")
-            print(f"Max tokens: {args.max_tokens}")
-        
-        # Change Whisper model if specified
-        if args.whisper and args.whisper != "tiny":
-            if repl.voice_manager.set_whisper(args.whisper):
-                if args.debug:
-                    print(f"Using Whisper model: {args.whisper}")
-        
-        # Start in voice mode automatically unless --no-listening is specified
-        if not args.no_listening:
-            print("Activating voice mode. Say 'stop' to exit voice mode.")
-            # Use the existing voice mode method
-            repl.do_voice("on")
-        
-        # Start the REPL
-        repl.cmdloop()
-        
-    except KeyboardInterrupt:
-        print("\nExiting AbstractVoice...")
-    except Exception as e:
-        print(f"Application error: {e}")
-        if args.debug:
-            import traceback
-            traceback.print_exc()
-
-if __name__ == "__main__":
-    main()