voice-mode 2.28.3__tar.gz → 2.30.0__tar.gz

{voice_mode-2.28.3 → voice_mode-2.30.0}/CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.30.0] - 2025-08-25
+
+## [2.29.0] - 2025-08-25
+
+### Added
+- **CoreML acceleration support for Whisper on Apple Silicon**
+  - Added optional dependency group 'coreml' with PyTorch and CoreMLTools
+  - Enhanced whisper_model_install tool with install_torch and auto_confirm parameters
+  - Automatic detection of Apple Silicon Macs with CoreML acceleration offer
+  - User-friendly confirmation prompts for large (~2.5GB) PyTorch download
+  - Graceful fallback to Metal acceleration if CoreML requirements not met
+  - Clear instructions for enabling CoreML later if initially skipped
+
+- **Beautiful installer experience**
+  - Added Voice Mode ASCII art in Claude Code orange color
+  - Enhanced preamble with clear value proposition and privacy messaging
+  - Early system detection with special recognition for Apple Silicon
+  - Professional presentation with centered text and visual hierarchy
+
+### Fixed
+- **Improved converse tool documentation**
+  - Simplified listen_duration parameter documentation
+  - Removed confusing duration recommendations that led to unnecessary overrides
+  - Clarified that silence detection handles timing well with sensible defaults
+  - Reduces cognitive load and prevents token waste from explicit duration settings
+
 ## [2.28.3] - 2025-08-24
 
 ### Fixed

{voice_mode-2.28.3 → voice_mode-2.30.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voice-mode
-Version: 2.28.3
+Version: 2.30.0
 Summary: VoiceMode - Voice interaction capabilities for AI assistants (formerly voice-mcp)
 Project-URL: Homepage, https://github.com/mbailey/voicemode
 Project-URL: Repository, https://github.com/mbailey/voicemode
@@ -39,6 +39,11 @@ Requires-Dist: simpleaudio
 Requires-Dist: sounddevice
 Requires-Dist: uv>=0.4.0
 Requires-Dist: webrtcvad>=2.0.10
+Provides-Extra: coreml
+Requires-Dist: ane-transformers; extra == 'coreml'
+Requires-Dist: coremltools>=7.0; extra == 'coreml'
+Requires-Dist: torch>=2.0.0; extra == 'coreml'
+Requires-Dist: transformers; extra == 'coreml'
 Provides-Extra: dev
 Requires-Dist: build>=1.0.0; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'

{voice_mode-2.28.3 → voice_mode-2.30.0}/pyproject.toml

@@ -50,6 +50,12 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
+coreml = [
+    "torch>=2.0.0",
+    "coremltools>=7.0",
+    "transformers",
+    "ane-transformers",
+]
 dev = [
     "build>=1.0.0",
     "twine>=4.0.0",

{voice_mode-2.28.3 → voice_mode-2.30.0}/voice_mode/__version__.py

@@ -1,3 +1,3 @@
 # This file is automatically updated by 'make release'
 # Do not edit manually
-__version__ = "2.28.3"
+__version__ = "2.30.0"

{voice_mode-2.28.3 → voice_mode-2.30.0}/voice_mode/cli.py

@@ -1694,18 +1694,89 @@ def version():
 @click.help_option('-h', '--help')
 @click.option('--force', is_flag=True, help='Force reinstall even if already up to date')
 def update(force):
-    """Update Voice Mode to the latest version."""
+    """Update Voice Mode to the latest version.
+    
+    Automatically detects installation method (UV tool, UV pip, or regular pip)
+    and uses the appropriate update command.
+    """
     import subprocess
     import requests
+    from pathlib import Path
     from importlib.metadata import version as get_version, PackageNotFoundError
     
+    def detect_uv_tool_installation():
+        """Detect if running from a UV tool installation."""
+        prefix_path = Path(sys.prefix).resolve()
+        uv_tools_base = Path.home() / ".local" / "share" / "uv" / "tools"
+        
+        # Check if sys.prefix is within UV tools directory
+        if uv_tools_base in prefix_path.parents or prefix_path.parent == uv_tools_base:
+            # Find the tool directory
+            tool_dir = prefix_path if prefix_path.parent == uv_tools_base else None
+            
+            if not tool_dir:
+                for parent in prefix_path.parents:
+                    if parent.parent == uv_tools_base:
+                        tool_dir = parent
+                        break
+            
+            if tool_dir:
+                # Verify with uv-receipt.toml
+                receipt_file = tool_dir / "uv-receipt.toml"
+                if receipt_file.exists():
+                    # Parse tool name from receipt or use directory name
+                    try:
+                        with open(receipt_file) as f:
+                            content = f.read()
+                            import re
+                            match = re.search(r'name = "([^"]+)"', content)
+                            tool_name = match.group(1) if match else tool_dir.name
+                            return True, tool_name
+                    except Exception:
+                        return True, tool_dir.name
+        
+        return False, None
+    
+    def detect_uv_venv():
+        """Detect if running in a UV-managed virtual environment."""
+        # Check if we're in a venv
+        if sys.prefix == sys.base_prefix:
+            return False
+        
+        # Check for UV markers in pyvenv.cfg
+        pyvenv_cfg = Path(sys.prefix) / "pyvenv.cfg"
+        if pyvenv_cfg.exists():
+            try:
+                with open(pyvenv_cfg) as f:
+                    content = f.read()
+                    if "uv" in content.lower() or "managed by uv" in content:
+                        return True
+            except Exception:
+                pass
+        
+        return False
+    
+    def check_uv_available():
+        """Check if UV is available."""
+        try:
+            result = subprocess.run(
+                ["uv", "--version"],
+                capture_output=True,
+                text=True,
+                timeout=2
+            )
+            return result.returncode == 0
+        except (FileNotFoundError, subprocess.TimeoutExpired):
+            return False
+    
+    # Get current version
     try:
         current_version = get_version("voice-mode")
     except PackageNotFoundError:
         current_version = "development"
     
+    # Check if update needed (unless forced)
     if not force and current_version != "development":
-        # Check if update is needed
         try:
             response = requests.get(
                 "https://pypi.org/pypi/voice-mode/json",
@@ -1717,58 +1788,82 @@ def update(force):
                     click.echo(f"Already running the latest version ({current_version})")
                     return
         except (requests.RequestException, KeyError, ValueError):
-            # Continue with update if we can't check
-            pass
+            pass  # Continue with update if we can't check
     
-    click.echo("Updating Voice Mode to the latest version...")
+    # Detect installation method
+    is_uv_tool, tool_name = detect_uv_tool_installation()
     
-    # Try UV first, fall back to pip
-    try:
-        # Check if UV is available
+    if is_uv_tool:
+        # UV tool installation - use uv tool upgrade
+        click.echo(f"Updating Voice Mode (UV tool: {tool_name})...")
+        
         result = subprocess.run(
-            ["uv", "--version"],
+            ["uv", "tool", "upgrade", tool_name],
             capture_output=True,
-            text=True,
-            check=False
+            text=True
         )
         
         if result.returncode == 0:
-            # Use UV for update
+            try:
+                new_version = get_version("voice-mode")
+                click.echo(f"✅ Successfully updated to version {new_version}")
+            except PackageNotFoundError:
+                click.echo("✅ Successfully updated Voice Mode")
+        else:
+            click.echo(f"❌ Update failed: {result.stderr}")
+            click.echo(f"Try running manually: uv tool upgrade {tool_name}")
+    
+    elif detect_uv_venv():
+        # UV-managed virtual environment
+        click.echo("Updating Voice Mode (UV virtual environment)...")
+        
+        result = subprocess.run(
+            ["uv", "pip", "install", "--upgrade", "voice-mode"],
+            capture_output=True,
+            text=True
+        )
+        
+        if result.returncode == 0:
+            try:
+                new_version = get_version("voice-mode")
+                click.echo(f"✅ Successfully updated to version {new_version}")
+            except PackageNotFoundError:
+                click.echo("✅ Successfully updated Voice Mode")
+        else:
+            click.echo(f"❌ Update failed: {result.stderr}")
+            click.echo("Try running: uv pip install --upgrade voice-mode")
+    
+    else:
+        # Standard installation - try UV if available, else pip
+        has_uv = check_uv_available()
+        
+        if has_uv:
+            click.echo("Updating Voice Mode (using UV)...")
             result = subprocess.run(
                 ["uv", "pip", "install", "--upgrade", "voice-mode"],
                 capture_output=True,
                 text=True
             )
-            if result.returncode == 0:
-                # Get new version
-                try:
-                    new_version = get_version("voice-mode")
-                    click.echo(f"✅ Successfully updated to version {new_version}")
-                except PackageNotFoundError:
-                    click.echo("✅ Successfully updated Voice Mode")
-            else:
-                click.echo(f"❌ Update failed: {result.stderr}")
-                click.echo("Try running: uv pip install --upgrade voice-mode")
         else:
-            # Fall back to pip
+            click.echo("Updating Voice Mode (using pip)...")
             result = subprocess.run(
                 [sys.executable, "-m", "pip", "install", "--upgrade", "voice-mode"],
                 capture_output=True,
                 text=True
             )
-            if result.returncode == 0:
-                try:
-                    new_version = get_version("voice-mode")
-                    click.echo(f"✅ Successfully updated to version {new_version}")
-                except PackageNotFoundError:
-                    click.echo("✅ Successfully updated Voice Mode")
+        
+        if result.returncode == 0:
+            try:
+                new_version = get_version("voice-mode")
+                click.echo(f"✅ Successfully updated to version {new_version}")
+            except PackageNotFoundError:
+                click.echo("✅ Successfully updated Voice Mode")
+        else:
+            click.echo(f"❌ Update failed: {result.stderr}")
+            if has_uv:
+                click.echo("Try running: uv pip install --upgrade voice-mode")
             else:
-                click.echo(f"❌ Update failed: {result.stderr}")
                 click.echo("Try running: pip install --upgrade voice-mode")
-    
-    except FileNotFoundError as e:
-        click.echo(f"❌ Update failed: {e}")
-        click.echo("Please install UV or pip and try again")
 
 
 # Completions command

{voice_mode-2.28.3 → voice_mode-2.30.0}/voice_mode/tools/converse.py

@@ -1351,14 +1351,13 @@ async def converse(
         message: The message to speak
         wait_for_response: Whether to listen for a response after speaking (default: True)
         listen_duration: How long to listen for response in seconds (default: 120.0)
-                         Recommended durations based on expected response:
-                         - Simple yes/no questions: 10 seconds
-                         - Normal conversational responses: 30 seconds  
-                         - Open-ended questions: 60 seconds
-                         - Detailed explanations: 120 seconds (default)
-                         - Stories or long explanations: 300 seconds
-                         Always err on the side of longer duration - it's better to have 
-                         silence at the end than to cut off the user mid-sentence.
+                         The tool handles silence detection well and uses a sensible default.
+                         It's unusual to need to set the duration - only override if you have 
+                         specific requirements such as:
+                         - Silence detection is disabled and you need a specific timeout
+                         - You know the response will be exceptionally long (>120s)
+                         - You're in a special mode that requires different timing
+                         In most cases, just let the default and silence detection handle it.
         min_listen_duration: Minimum time to record before silence detection can stop (default: 2.0)
                              Useful for preventing premature cutoffs when users need thinking time.
                              Examples:

{voice_mode-2.28.3 → voice_mode-2.30.0}/voice_mode/tools/services/whisper/model_install.py

@@ -1,10 +1,13 @@
 """Download Whisper models with Core ML support."""
 
 import os
+import sys
 import json
 import logging
+import platform
+import subprocess
 from pathlib import Path
-from typing import Union, List
+from typing import Union, List, Dict, Any
 
 from voice_mode.server import mcp
 from voice_mode.config import logger, MODELS_DIR
@@ -17,7 +20,9 @@ logger = logging.getLogger("voice-mode")
 async def whisper_model_install(
     model: Union[str, List[str]] = "large-v2",
     force_download: Union[bool, str] = False,
-    skip_core_ml: Union[bool, str] = False
+    skip_core_ml: Union[bool, str] = False,
+    install_torch: Union[bool, str] = False,
+    auto_confirm: Union[bool, str] = False
 ) -> str:
     """Download Whisper model(s) with optional Core ML conversion.
     
@@ -31,6 +36,8 @@ async def whisper_model_install(
                - "all" to download all available models
         force_download: Re-download even if model exists (default: False)
         skip_core_ml: Skip Core ML conversion on Apple Silicon (default: False)
+        install_torch: Install PyTorch for CoreML (adds ~2.5GB) (default: False)
+        auto_confirm: Skip all confirmation prompts (default: False)
         
     Available models:
         - tiny, tiny.en
@@ -77,6 +84,20 @@ async def whisper_model_install(
                 "error": "Whisper.cpp not installed. Please run whisper_install first."
             }, indent=2)
         
+        # Handle CoreML dependencies if needed
+        coreml_status = await _handle_coreml_dependencies(
+            install_torch=install_torch,
+            auto_confirm=auto_confirm,
+            skip_core_ml=skip_core_ml
+        )
+        
+        if not coreml_status["continue"]:
+            return json.dumps(coreml_status, indent=2)
+        
+        # If CoreML deps were installed, skip_core_ml may have been updated
+        if coreml_status.get("coreml_deps_failed"):
+            skip_core_ml = True
+        
         # Parse model input
         available_models = get_available_models()
         
@@ -200,4 +221,79 @@ async def whisper_model_install(
         return json.dumps({
             "success": False,
             "error": str(e)
-        }, indent=2)
+        }, indent=2)
+
+
+async def _handle_coreml_dependencies(
+    install_torch: bool = False,
+    auto_confirm: bool = False,
+    skip_core_ml: bool = False
+) -> Dict[str, Any]:
+    """Handle CoreML dependency installation for Apple Silicon Macs.
+    
+    Returns:
+        Dict with 'continue' key indicating whether to proceed with model download
+    """
+    # Check if we're on Apple Silicon Mac
+    if platform.system() != "Darwin" or platform.machine() != "arm64":
+        return {"continue": True}
+    
+    # If skipping CoreML, no need to check dependencies
+    if skip_core_ml:
+        return {"continue": True}
+    
+    # Check if torch is already installed
+    try:
+        import torch
+        logger.info("PyTorch already installed for CoreML support")
+        return {"continue": True}
+    except ImportError:
+        pass
+    
+    # Check if user wants to install torch
+    if not install_torch and not auto_confirm:
+        return {
+            "continue": False,
+            "success": False,
+            "requires_confirmation": True,
+            "message": "CoreML requires PyTorch (~2.5GB). Rerun with install_torch=True to confirm.",
+            "recommendation": "Set install_torch=True for CoreML acceleration (2-3x faster)"
+        }
+    
+    # Install CoreML dependencies
+    logger.info("Installing CoreML dependencies...")
+    
+    try:
+        # Detect environment and install appropriately
+        packages = ["torch>=2.0.0", "coremltools>=7.0", "transformers", "ane-transformers"]
+        
+        # Try UV first (most common)
+        if subprocess.run(["which", "uv"], capture_output=True).returncode == 0:
+            cmd = ["uv", "pip", "install"] + packages
+            logger.info("Installing via UV...")
+        else:
+            # Fallback to pip
+            cmd = [sys.executable, "-m", "pip", "install"] + packages
+            logger.info("Installing via pip...")
+        
+        # Run installation
+        result = subprocess.run(cmd, capture_output=True, text=True)
+        
+        if result.returncode == 0:
+            logger.info("CoreML dependencies installed successfully")
+            return {"continue": True, "coreml_deps_installed": True}
+        else:
+            logger.warning(f"Failed to install CoreML dependencies: {result.stderr}")
+            return {
+                "continue": True,
+                "coreml_deps_failed": True,
+                "warning": "CoreML dependencies installation failed. Models will use Metal acceleration."
+            }
+            
+    except Exception as e:
+        logger.warning(f"Error installing CoreML dependencies: {e}")
+        return {
+            "continue": True,
+            "coreml_deps_failed": True,
+            "warning": f"CoreML setup error: {str(e)}. Models will use Metal acceleration."
+        }