abstractvoice 0.2.0__tar.gz → 0.3.0__tar.gz

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

@@ -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 → 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.0 → abstractvoice-0.3.0}/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-0.3.0/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-0.2.0 → 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()