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

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-0.2.1.dist-info → abstractvoice-0.3.0.dist-info}/METADATA

@@ -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.dist-info → abstractvoice-0.3.0.dist-info}/RECORD

@@ -4,8 +4,8 @@ abstractvoice/dependency_check.py,sha256=BUUADz4un4_FCZzNpgwk1qpJ6yqVi5Pvjfd3JLS
 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
@@ -13,9 +13,9 @@ abstractvoice/tts/__init__.py,sha256=WgJrxqdc_qaRyfFt1jbgMQD9S757jYuBpDzMRB02TFs
 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.1.dist-info/licenses/LICENSE,sha256=TiDPM5WcFRQPoC5e46jGMeMppZ-eu0eFx_HytjE49bk,1105
-abstractvoice-0.2.1.dist-info/METADATA,sha256=KFp786KB4_KECTUvlTdWgvLkiTPXhrHhJup9huRAESs,37533
-abstractvoice-0.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-abstractvoice-0.2.1.dist-info/entry_points.txt,sha256=rL63lqtLrbd7w_hGsR_w9Mr5baq4p3Mzwn4_UJqR_nI,120
-abstractvoice-0.2.1.dist-info/top_level.txt,sha256=a1qyxqgF1O8cJtPKpcJuImGZ_uXqPNghbLZ9gp-UiOo,14
-abstractvoice-0.2.1.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.1.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