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

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

@@ -7,6 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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.29.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voice-mode
-Version: 2.28.3
+Version: 2.29.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.29.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.29.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.29.0"

{voice_mode-2.28.3 → voice_mode-2.29.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.29.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."
+        }