Release v5.1.6

Added

• Release Management Script - Automated script for version bumping and release preparation
• Homebrew Auto-Installation - Automatic detection and installation of Homebrew on macOS

Fixed

• dpkg False Positives - Fixed false positive detections in dpkg checks
• Tart VM Targets - Added support for Tart VM testing targets

Changed

• Makefile Cleanup - Reorganized and cleaned up Makefile structure

Documentation

• Code Reading Guide - Added comprehensive guide for understanding voicemode converse command

Installation

Universal Installer (Recommended)

Install Claude Code with Voice Mode configured and ready to run on Linux, macOS, and Windows WSL:

curl -O https://getvoicemode.com/install.sh && bash install.sh

This installer will:

• Install all system dependencies (Node.js, audio libraries, etc.)
• Install Claude Code if not already installed
• Configure Voice Mode as an MCP server
• Set up your system for voice conversations

Manual Installation

PyPI

pip install voice-mode==5.1.6

Claude Code MCP

claude mcp add voice-mode uvx voice-mode

Release v5.1.5

Installation

Universal Installer (Recommended)

Install Claude Code with Voice Mode configured and ready to run on Linux, macOS, and Windows WSL:

curl -O https://getvoicemode.com/install.sh && bash install.sh

This installer will:

• Install all system dependencies (Node.js, audio libraries, etc.)
• Install Claude Code if not already installed
• Configure Voice Mode as an MCP server
• Set up your system for voice conversations

Manual Installation

PyPI

pip install voice-mode==5.1.5

Claude Code MCP

claude mcp add voice-mode uvx voice-mode

Release v5.1.4

Added

• voice-mode-install Package - Standalone installer package for simplified VoiceMode setup
  • New PyPI package voice-mode-install provides voice-mode-install command
  • Handles system dependency detection and installation before main package
  • Cross-platform support for macOS, Ubuntu/Debian, and Fedora
  • Interactive prompts with smart defaults for dependency installation
  • Detects OS, distribution, and architecture automatically
  • Shows concise summary of missing system packages
  • Installs system dependencies using native package managers (brew/apt/dnf)
  • Automatically installs VoiceMode after dependencies are ready
  • Makefile targets for building, testing, and publishing installer package
  • Improved command existence checking using shutil.which

Installation

Universal Installer (Recommended)

Install Claude Code with Voice Mode configured and ready to run on Linux, macOS, and Windows WSL:

curl -O https://getvoicemode.com/install.sh && bash install.sh

This installer will:

• Install all system dependencies (Node.js, audio libraries, etc.)
• Install Claude Code if not already installed
• Configure Voice Mode as an MCP server
• Set up your system for voice conversations

Manual Installation

PyPI

pip install voice-mode==5.1.4

Claude Code MCP

claude mcp add voice-mode uvx voice-mode

Release v5.1.3

Fixed

• Kokoro First-Time Installation Timeout
  • Fixed systemd timeout error during first kokoro installation
  • Now starts kokoro manually before systemd to download models and dependencies
  • Waits for health check (max 3 minutes) before creating systemd service
  • Eliminates "timeout exceeded" errors on first install
  • Systemd service starts quickly on subsequent boots since everything is cached

Installation

Universal Installer (Recommended)

Install Claude Code with Voice Mode configured and ready to run on Linux, macOS, and Windows WSL:

curl -O https://getvoicemode.com/install.sh && bash install.sh

This installer will:

• Install all system dependencies (Node.js, audio libraries, etc.)
• Install Claude Code if not already installed
• Configure Voice Mode as an MCP server
• Set up your system for voice conversations

Manual Installation

PyPI

pip install voice-mode==5.1.3

Claude Code MCP

claude mcp add voice-mode uvx voice-mode

Release v5.1.2

Fixed

• Kokoro Rust Dependency Detection
  • Fixed voicemode kokoro install failing with "can't find Rust compiler" on Fedora
  • Marked Rust (cargo and rustc) as required dependencies for kokoro on Fedora
  • Previously marked as optional (ARM64 only), but sudachipy requires Rust on all architectures
  • Dependency chain: kokoro-fastapi → misaki[ja] → pyopenjtalk-plus → sudachipy
  • voicemode deps --component kokoro now correctly checks for Rust compiler

Changed

• Service Auto-Enable Default
  • Changed SERVICE_AUTO_ENABLE default from False to True
  • Services now automatically enable and start after installation by default
  • Users can override with VOICEMODE_SERVICE_AUTO_ENABLE=false if desired
  • Improves out-of-box experience - services "just work" after installation

Installation

Universal Installer (Recommended)

Install Claude Code with Voice Mode configured and ready to run on Linux, macOS, and Windows WSL:

curl -O https://getvoicemode.com/install.sh && bash install.sh

This installer will:

• Install all system dependencies (Node.js, audio libraries, etc.)
• Install Claude Code if not already installed
• Configure Voice Mode as an MCP server
• Set up your system for voice conversations

Manual Installation

PyPI

pip install voice-mode==5.1.2

Claude Code MCP

claude mcp add voice-mode uvx voice-mode

Release v5.1.1

Added

• Progress Indicator for Dependency Installation
  • Animated braille spinner shows installation activity by default
  • New --verbose/-v flag for voicemode deps to show full package manager output
  • Friendly progress messages with emoji (📦, ✅, ❌)
  • Spinner runs in daemon thread for clean shutdown
  • Addresses user feedback about installation appearing to hang with no progress indication

Fixed

• Kokoro Service PATH Configuration
  • Fixed hardcoded /home/m/.local/bin in systemd service file
  • Now uses dynamic user home directory expansion with os.path.expanduser()
  • Fixes "ModuleNotFoundError: No module named 'loguru'" and "Failed to spawn: uvicorn" errors
  • Affects any Linux user with username other than 'm'
  • Bug present since v2.16.0 (July 2025)

Installation

Universal Installer (Recommended)

Install Claude Code with Voice Mode configured and ready to run on Linux, macOS, and Windows WSL:

curl -O https://getvoicemode.com/install.sh && bash install.sh

This installer will:

• Install all system dependencies (Node.js, audio libraries, etc.)
• Install Claude Code if not already installed
• Configure Voice Mode as an MCP server
• Set up your system for voice conversations

Manual Installation

PyPI

pip install voice-mode==5.1.1

Claude Code MCP

claude mcp add voice-mode uvx voice-mode

Release v5.1.0

Added

• Lazy-Loading System Dependency Management - Complete dependency checking and installation system
  • Automatic detection and installation of system dependencies on-demand
  • Lazy dependency checking that happens when needed (core deps on converse, build deps on service install)
  • Single source of truth in voice_mode/dependencies.yaml for all platform dependencies
  • CLI command voicemode deps to check and install dependencies interactively
  • Non-interactive mode with --yes flag for automation
  • Component-specific checking with --component flag (whisper, kokoro, core)
  • Cross-platform support for Fedora, Ubuntu/Debian, and macOS
  • In-memory caching of dependency status for performance
  • WSL2-specific dependency handling (pulseaudio requirements)

Fixed

• ALSA Development Libraries Now Required for Core Installation
  • Fixed installation failures on Linux due to missing ALSA headers
  • simpleaudio Python package requires ALSA development libraries to compile
  • Updated dependencies.yaml to mark as required:
    • Fedora: alsa-lib-devel
    • Ubuntu/Debian: libasound2-dev
  • Previously marked as optional, causing uv tool install failures
  • Affects all Linux platforms (native and WSL)
  • Tested on Fedora 42 ARM64

Installation

Universal Installer (Recommended)

Install Claude Code with Voice Mode configured and ready to run on Linux, macOS, and Windows WSL:

curl -O https://getvoicemode.com/install.sh && bash install.sh

This installer will:

• Install all system dependencies (Node.js, audio libraries, etc.)
• Install Claude Code if not already installed
• Configure Voice Mode as an MCP server
• Set up your system for voice conversations

Manual Installation

PyPI

pip install voice-mode==5.1.0

Claude Code MCP

claude mcp add voice-mode uvx voice-mode

Release v5.0.3

Fixed

• Whisper Model Default - Consolidated default Whisper model to single constant
  • Fixed inconsistency where CLI defaulted to large-v2 while tool used base
  • All code now references DEFAULT_WHISPER_MODEL = "base" from config.py
  • DRY principle applied across CLI and tool implementations

Installation

Universal Installer (Recommended)

Install Claude Code with Voice Mode configured and ready to run on Linux, macOS, and Windows WSL:

curl -O https://getvoicemode.com/install.sh && bash install.sh

This installer will:

• Install all system dependencies (Node.js, audio libraries, etc.)
• Install Claude Code if not already installed
• Configure Voice Mode as an MCP server
• Set up your system for voice conversations

Manual Installation

PyPI

pip install voice-mode==5.0.3

Claude Code MCP

claude mcp add voice-mode uvx voice-mode

Release v5.0.2

Fixed

• CLI Error Messages - Display meaningful OpenAI error messages in CLI commands
  • Improved error reporting throughout CLI interface
  • Better user feedback when OpenAI API calls fail

Installation

Universal Installer (Recommended)

Install Claude Code with Voice Mode configured and ready to run on Linux, macOS, and Windows WSL:

curl -O https://getvoicemode.com/install.sh && bash install.sh

This installer will:

• Install all system dependencies (Node.js, audio libraries, etc.)
• Install Claude Code if not already installed
• Configure Voice Mode as an MCP server
• Set up your system for voice conversations

Manual Installation

PyPI

pip install voice-mode==5.0.2

Claude Code MCP

claude mcp add voice-mode uvx voice-mode

Release v5.0.1

Fixed

• Version Command - Fixed NameError caused by undefined current_version variable

Installation

Universal Installer (Recommended)

Install Claude Code with Voice Mode configured and ready to run on Linux, macOS, and Windows WSL:

curl -O https://getvoicemode.com/install.sh && bash install.sh

This installer will:

• Install all system dependencies (Node.js, audio libraries, etc.)
• Install Claude Code if not already installed
• Configure Voice Mode as an MCP server
• Set up your system for voice conversations

Manual Installation

PyPI

pip install voice-mode==5.0.1

Claude Code MCP

claude mcp add voice-mode uvx voice-mode