feat: add automated installation scripts and model checking

- Add install.sh for automated installation on Linux/Mac
- Add install.ps1 for automated installation on Windows
- Scripts automatically:
- Check Python version
- Create virtual environment
- Install dependencies
- Download wake word models and sound effects
- Create .env configuration file
- Check Reachy Mini SDK installation
- Check audio devices
- Add model file checking in __init__.py
- Warn users if required files are missing
- Provide clear instructions for downloading missing files
- Users can now install with a single command

install.ps1

@@ -0,0 +1,100 @@
+# Automated installation script for Reachy Mini Home Assistant Voice Assistant
+
+$ErrorActionPreference = "Stop"
+
+Write-Host "==========================================" -ForegroundColor Cyan
+Write-Host "Reachy Mini Home Assistant Voice Assistant" -ForegroundColor Cyan
+Write-Host "Automated Installation Script" -ForegroundColor Cyan
+Write-Host "==========================================" -ForegroundColor Cyan
+Write-Host ""
+
+# Check Python version
+Write-Host "Checking Python version..." -ForegroundColor Yellow
+try {
+    $pythonVersion = python --version 2>&1
+    Write-Host "✓ Python version: $pythonVersion" -ForegroundColor Green
+} catch {
+    Write-Host "✗ Python not found. Please install Python 3.8 or higher." -ForegroundColor Red
+    exit 1
+}
+Write-Host ""
+
+# Create virtual environment
+Write-Host "Creating virtual environment..." -ForegroundColor Yellow
+python -m venv .venv
+Write-Host "✓ Virtual environment created" -ForegroundColor Green
+Write-Host ""
+
+# Activate virtual environment
+Write-Host "Activating virtual environment..." -ForegroundColor Yellow
+& .\.venv\Scripts\Activate.ps1
+Write-Host "✓ Virtual environment activated" -ForegroundColor Green
+Write-Host ""
+
+# Upgrade pip
+Write-Host "Upgrading pip..." -ForegroundColor Yellow
+python -m pip install --upgrade pip
+Write-Host "✓ Pip upgraded" -ForegroundColor Green
+Write-Host ""
+
+# Install dependencies
+Write-Host "Installing dependencies..." -ForegroundColor Yellow
+pip install -e .
+Write-Host "✓ Dependencies installed" -ForegroundColor Green
+Write-Host ""
+
+# Download wake word models and sound effects
+Write-Host "Downloading wake word models and sound effects..." -ForegroundColor Yellow
+powershell -ExecutionPolicy Bypass -File download_models.ps1
+Write-Host "✓ Models and sound effects downloaded" -ForegroundColor Green
+Write-Host ""
+
+# Copy environment template
+Write-Host "Creating environment configuration..." -ForegroundColor Yellow
+if (-not (Test-Path ".env")) {
+    Copy-Item .env.example .env
+    Write-Host "✓ Created .env file from template" -ForegroundColor Green
+} else {
+    Write-Host "⚠ .env file already exists, skipping..." -ForegroundColor Yellow
+}
+Write-Host ""
+
+# Check if Reachy Mini SDK is installed
+Write-Host "Checking Reachy Mini SDK..." -ForegroundColor Yellow
+try {
+    python -c "import reachy_mini" 2>$null
+    Write-Host "✓ Reachy Mini SDK is installed" -ForegroundColor Green
+} catch {
+    Write-Host "⚠ Reachy Mini SDK is not installed" -ForegroundColor Yellow
+    Write-Host "  Please install it with: pip install reachy-mini" -ForegroundColor Gray
+    Write-Host "  Or for wireless version: pip install reachy-mini[wireless]" -ForegroundColor Gray
+}
+Write-Host ""
+
+# Check audio devices
+Write-Host "Checking audio devices..." -ForegroundColor Yellow
+try {
+    python -m reachy_mini_ha_voice --list-input-devices 2>$null
+} catch {
+    Write-Host "  (Will check on first run)" -ForegroundColor Gray
+}
+try {
+    python -m reachy_mini_ha_voice --list-output-devices 2>$null
+} catch {
+    Write-Host "  (Will check on first run)" -ForegroundColor Gray
+}
+Write-Host ""
+
+# Installation complete
+Write-Host "==========================================" -ForegroundColor Cyan
+Write-Host "✓ Installation complete!" -ForegroundColor Green
+Write-Host "==========================================" -ForegroundColor Cyan
+Write-Host ""
+Write-Host "Next steps:" -ForegroundColor Cyan
+Write-Host "1. Edit .env file to configure your settings" -ForegroundColor White
+Write-Host "2. Run the application:" -ForegroundColor White
+Write-Host "   .\.venv\Scripts\Activate.ps1" -ForegroundColor Gray
+Write-Host "   python -m reachy_mini_ha_voice" -ForegroundColor Gray
+Write-Host ""
+Write-Host "For more information, see README.md or QUICKSTART.md" -ForegroundColor Gray
+Write-Host ""

install.sh

@@ -0,0 +1,95 @@
+#!/bin/bash
+# Automated installation script for Reachy Mini Home Assistant Voice Assistant
+
+set -e  # Exit on error
+
+echo "=========================================="
+echo "Reachy Mini Home Assistant Voice Assistant"
+echo "Automated Installation Script"
+echo "=========================================="
+echo ""
+
+# Check Python version
+echo "Checking Python version..."
+PYTHON_VERSION=$(python3 --version 2>&1 | awk '{print $2}')
+PYTHON_MAJOR=$(echo $PYTHON_VERSION | cut -d. -f1)
+PYTHON_MINOR=$(echo $PYTHON_VERSION | cut -d. -f2)
+
+if [ "$PYTHON_MAJOR" -lt 3 ] || ([ "$PYTHON_MAJOR" -eq 3 ] && [ "$PYTHON_MINOR" -lt 8 ]); then
+    echo "Error: Python 3.8 or higher is required. Found: $PYTHON_VERSION"
+    exit 1
+fi
+
+echo "✓ Python version: $PYTHON_VERSION"
+echo ""
+
+# Create virtual environment
+echo "Creating virtual environment..."
+python3 -m venv .venv
+echo "✓ Virtual environment created"
+echo ""
+
+# Activate virtual environment
+echo "Activating virtual environment..."
+source .venv/bin/activate
+echo "✓ Virtual environment activated"
+echo ""
+
+# Upgrade pip
+echo "Upgrading pip..."
+pip install --upgrade pip
+echo "✓ Pip upgraded"
+echo ""
+
+# Install dependencies
+echo "Installing dependencies..."
+pip install -e .
+echo "✓ Dependencies installed"
+echo ""
+
+# Download wake word models and sound effects
+echo "Downloading wake word models and sound effects..."
+./download_models.sh
+echo "✓ Models and sound effects downloaded"
+echo ""
+
+# Copy environment template
+echo "Creating environment configuration..."
+if [ ! -f .env ]; then
+    cp .env.example .env
+    echo "✓ Created .env file from template"
+else
+    echo "⚠ .env file already exists, skipping..."
+fi
+echo ""
+
+# Check if Reachy Mini SDK is installed
+echo "Checking Reachy Mini SDK..."
+if python -c "import reachy_mini" 2>/dev/null; then
+    echo "✓ Reachy Mini SDK is installed"
+else
+    echo "⚠ Reachy Mini SDK is not installed"
+    echo "  Please install it with: pip install reachy-mini"
+    echo "  Or for wireless version: pip install reachy-mini[wireless]"
+fi
+echo ""
+
+# Check audio devices
+echo "Checking audio devices..."
+python -m reachy_mini_ha_voice --list-input-devices 2>/dev/null || echo "  (Will check on first run)"
+python -m reachy_mini_ha_voice --list-output-devices 2>/dev/null || echo "  (Will check on first run)"
+echo ""
+
+# Installation complete
+echo "=========================================="
+echo "✓ Installation complete!"
+echo "=========================================="
+echo ""
+echo "Next steps:"
+echo "1. Edit .env file to configure your settings"
+echo "2. Run the application:"
+echo "   source .venv/bin/activate"
+echo "   python -m reachy_mini_ha_voice"
+echo ""
+echo "For more information, see README.md or QUICKSTART.md"
+echo ""

src/reachy_mini_ha_voice/__init__.py

@@ -1,14 +1,73 @@
 """
 Reachy Mini Home Assistant Voice Assistant
 
-A voice assistant for Reachy Mini robot that integrates with Home Assistant
-via the ESPHome protocol.
+A voice assistant application that runs on Reachy Mini robot and integrates
+with Home Assistant via the ESPHome protocol.
 """
 
 __version__ = "0.1.0"
 __author__ = "Your Name"
 __email__ = "your.email@example.com"
 
-from .main import main
+# Check for required models on import
+import os
+import sys
+from pathlib import Path
 
-__all__ = ["main", "__version__"]
+def check_required_files():
+    """Check if required model files exist"""
+    wakewords_dir = Path(__file__).parent.parent.parent / "wakewords"
+    sounds_dir = Path(__file__).parent.parent.parent / "sounds"
+    
+    missing_files = []
+    
+    # Check wake word models
+    required_models = [
+        wakewords_dir / "okay_nabu.tflite",
+        wakewords_dir / "okay_nabu.json",
+    ]
+    
+    for model_file in required_models:
+        if not model_file.exists():
+            missing_files.append(model_file.name)
+    
+    # Check sound effects
+    required_sounds = [
+        sounds_dir / "wake_word_triggered.flac",
+        sounds_dir / "timer_finished.flac",
+    ]
+    
+    for sound_file in required_sounds:
+        if not sound_file.exists():
+            missing_files.append(sound_file.name)
+    
+    if missing_files:
+        print("\n" + "="*60)
+        print("WARNING: Required files are missing!")
+        print("="*60)
+        print("\nMissing files:")
+        for file in missing_files:
+            print(f"  - {file}")
+        
+        print("\nPlease run the download script:")
+        print("  Linux/Mac: ./download_models.sh")
+        print("  Windows: powershell -ExecutionPolicy Bypass -File download_models.ps1")
+        print("\nOr run the automated installation script:")
+        print("  Linux/Mac: ./install.sh")
+        print("  Windows: powershell -ExecutionPolicy Bypass -File install.ps1")
+        print("="*60 + "\n")
+        return False
+    
+    return True
+
+# Check on import
+check_required_files()
+
+from .app import ReachyMiniVoiceApp
+from .state import ServerState
+
+__all__ = [
+    "ReachyMiniVoiceApp",
+    "ServerState",
+    "__version__",
+]