agent-cli 0.70.5__py3-none-any.whl

agent_cli/scripts/run-openwakeword.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+echo "👂 Starting Wyoming OpenWakeWord on port 10400..."
+
+# Use the LiteRT fork until the PR is merged
+# PR: https://github.com/rhasspy/wyoming-openwakeword/pull/XXX
+# This version works on macOS and other platforms without tflite-runtime
+
+uvx --python 3.12 --from git+https://github.com/basnijholt/wyoming-openwakeword.git@litert \
+    wyoming-openwakeword \
+    --uri 'tcp://0.0.0.0:10400' \
+    --preload-model 'ok_nabu'

agent_cli/scripts/run-piper-windows.ps1

@@ -0,0 +1,30 @@
+# PowerShell script to run Wyoming Piper TTS on Windows
+# Run with: powershell -ExecutionPolicy Bypass -File scripts/run-piper-windows.ps1
+
+Write-Host "🔊 Starting Wyoming Piper on port 10200..." -ForegroundColor Cyan
+
+# Create .runtime directory
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$RuntimeDir = Join-Path $ScriptDir ".runtime"
+$PiperDataDir = Join-Path $RuntimeDir "piper-data"
+if (-not (Test-Path $PiperDataDir)) {
+    New-Item -ItemType Directory -Path $PiperDataDir -Force | Out-Null
+}
+
+# Download voice if not present
+$VoiceDir = Join-Path $PiperDataDir "en_US-lessac-medium"
+if (-not (Test-Path $VoiceDir)) {
+    Write-Host "⬇️ Downloading voice model..." -ForegroundColor Yellow
+    Push-Location $PiperDataDir
+    uvx --python 3.12 --from piper-tts python -m piper.download_voices en_US-lessac-medium
+    Pop-Location
+}
+
+# Run Wyoming Piper using uvx
+uvx --python 3.12 `
+    --from "git+https://github.com/rhasspy/wyoming-piper.git@v2.1.1" `
+    wyoming-piper `
+    --voice en_US-lessac-medium `
+    --uri "tcp://0.0.0.0:10200" `
+    --data-dir $PiperDataDir `
+    --download-dir $PiperDataDir

agent_cli/scripts/run-piper.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+echo "🔊 Starting Wyoming Piper on port 10200..."
+
+# Create .runtime directory for local assets
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+mkdir -p "$SCRIPT_DIR/.runtime"
+
+# Download voice if not present using uvx
+if [ ! -d "$SCRIPT_DIR/.runtime/piper-data/en_US-lessac-medium" ]; then
+    echo "⬇️ Downloading voice model..."
+    mkdir -p "$SCRIPT_DIR/.runtime/piper-data"
+    cd "$SCRIPT_DIR/.runtime/piper-data"
+    uvx --python 3.12 --from piper-tts python -m piper.download_voices en_US-lessac-medium
+    cd "$SCRIPT_DIR"
+fi
+
+# Run Wyoming Piper using uvx wrapper
+uvx --python 3.12 \
+    --from git+https://github.com/rhasspy/wyoming-piper.git@v2.1.1 \
+    wyoming-piper \
+    --voice en_US-lessac-medium \
+    --uri 'tcp://0.0.0.0:10200' \
+    --data-dir "$SCRIPT_DIR/.runtime/piper-data" \
+    --download-dir "$SCRIPT_DIR/.runtime/piper-data"

agent_cli/scripts/run-whisper-linux.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+# Linux: faster-whisper with CUDA/CPU detection
+echo "🎤 Starting Wyoming Faster Whisper on port 10300..."
+
+# Detect if CUDA is available
+if command -v nvidia-smi &> /dev/null && nvidia-smi &> /dev/null; then
+    echo "⚡ NVIDIA GPU detected"
+    DETECTED_DEVICE="cuda"
+else
+    echo "💻 No GPU detected or CUDA unavailable"
+    DETECTED_DEVICE="cpu"
+fi
+
+# Allow device override via environment variable
+DEVICE="${WHISPER_DEVICE:-$DETECTED_DEVICE}"
+
+# Set default model based on final device choice
+if [ "$DEVICE" = "cuda" ]; then
+    DEFAULT_MODEL="large-v3"
+else
+    DEFAULT_MODEL="tiny"
+fi
+
+# Allow model override via environment variable
+MODEL="${WHISPER_MODEL:-$DEFAULT_MODEL}"
+echo "📦 Using model: $MODEL on device: $DEVICE"
+
+# Create .runtime directory for whisper data
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+mkdir -p "$SCRIPT_DIR/.runtime"
+
+uvx --python 3.12 \
+    --from git+https://github.com/rhasspy/wyoming-faster-whisper.git@v3.0.1 \
+    wyoming-faster-whisper \
+    --model "$MODEL" \
+    --language en \
+    --device "$DEVICE" \
+    --uri 'tcp://0.0.0.0:10300' \
+    --data-dir "$SCRIPT_DIR/.runtime/whisper-data" \
+    --download-dir "$SCRIPT_DIR/.runtime/whisper-data"

agent_cli/scripts/run-whisper-macos.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+# macOS: MLX-based Whisper for Apple Silicon
+echo "🎤 Starting Wyoming MLX Whisper on port 10300..."
+echo "🍎 Using MLX for Apple Silicon optimization"
+
+uvx --python 3.12 wyoming-mlx-whisper

agent_cli/scripts/run-whisper-windows.ps1

@@ -0,0 +1,51 @@
+# PowerShell script to run Wyoming Faster Whisper on Windows
+# Run with: powershell -ExecutionPolicy Bypass -File scripts/run-whisper-windows.ps1
+
+Write-Host "🎤 Starting Wyoming Faster Whisper on port 10300..." -ForegroundColor Cyan
+
+# Create .runtime directory
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$RuntimeDir = Join-Path $ScriptDir ".runtime"
+$WhisperDataDir = Join-Path $RuntimeDir "whisper-data"
+if (-not (Test-Path $WhisperDataDir)) {
+    New-Item -ItemType Directory -Path $WhisperDataDir -Force | Out-Null
+}
+
+# Detect if CUDA is available
+$Device = "cpu"
+$Model = "tiny"
+
+try {
+    $nvidiaSmi = Get-Command nvidia-smi -ErrorAction SilentlyContinue
+    if ($nvidiaSmi) {
+        $null = & nvidia-smi 2>&1
+        if ($LASTEXITCODE -eq 0) {
+            Write-Host "⚡ NVIDIA GPU detected" -ForegroundColor Green
+            $Device = "cuda"
+            $Model = "large-v3"
+        }
+    }
+} catch {
+    # nvidia-smi not found or failed
+}
+
+if ($Device -eq "cpu") {
+    Write-Host "💻 No GPU detected or CUDA unavailable, using CPU" -ForegroundColor Yellow
+}
+
+# Allow override via environment variables
+if ($env:WHISPER_DEVICE) { $Device = $env:WHISPER_DEVICE }
+if ($env:WHISPER_MODEL) { $Model = $env:WHISPER_MODEL }
+
+Write-Host "📦 Using model: $Model on device: $Device" -ForegroundColor Cyan
+
+# Run Wyoming Faster Whisper using uvx
+uvx --python 3.12 `
+    --from "git+https://github.com/rhasspy/wyoming-faster-whisper.git@v3.0.1" `
+    wyoming-faster-whisper `
+    --model $Model `
+    --language en `
+    --device $Device `
+    --uri "tcp://0.0.0.0:10300" `
+    --data-dir $WhisperDataDir `
+    --download-dir $WhisperDataDir

agent_cli/scripts/run-whisper.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+# Wrapper that calls the platform-specific whisper script
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+if [ "$(uname -s)" = "Darwin" ]; then
+    exec "$SCRIPT_DIR/run-whisper-macos.sh"
+else
+    exec "$SCRIPT_DIR/run-whisper-linux.sh"
+fi

agent_cli/scripts/run_faster_whisper_server.py

@@ -0,0 +1,136 @@
+#!/usr/bin/env -S uv run --script
+#
+# /// script
+# requires-python = ">=3.12"
+# dependencies = [
+#   "typer>=0.12",
+#   "fastapi>=0.115",
+#   "uvicorn>=0.30",
+#   "python-multipart>=0.0.9",
+#   "faster-whisper>=1.1.1",
+# ]
+# ///
+
+"""Minimal FastAPI server exposing faster-whisper transcription.
+
+Run directly with uv:
+
+  ./scripts/run_faster_whisper_server.py --model large-v3 --host 0.0.0.0 --port 8811
+
+Then point agent-cli at it, e.g.:
+
+  agent-cli transcribe --asr-openai-base-url http://localhost:8811/v1 --asr-openai-model large-v3
+
+Note: agent-cli requires a `--asr-openai-model` value in the request, but this server ignores it and always uses the model you start it with (`--model`).
+"""
+
+from __future__ import annotations
+
+import tempfile
+import threading
+from pathlib import Path
+from typing import Annotated
+
+import typer
+import uvicorn
+from fastapi import FastAPI, File, UploadFile
+from fastapi.responses import JSONResponse
+from faster_whisper import WhisperModel
+
+# Defaults configurable via environment if desired.
+DEFAULT_MODEL = "large-v3"
+DEFAULT_HOST = "0.0.0.0"  # noqa: S104
+DEFAULT_PORT = 8811
+DEFAULT_DEVICE = "auto"
+DEFAULT_COMPUTE_TYPE = "default"
+DEFAULT_LOG_LEVEL = "info"
+
+
+class ModelHolder:
+    """Thread-safe lazy model loader so we only download/init once."""
+
+    def __init__(self, model_id: str, device: str, compute_type: str) -> None:
+        """Store model configuration."""
+        self.model_id = model_id
+        self.device = device
+        self.compute_type = compute_type
+        self._model: WhisperModel | None = None
+        self._lock = threading.Lock()
+
+    def get(self) -> WhisperModel:
+        """Load or return the cached WhisperModel instance."""
+        if self._model is None:
+            with self._lock:
+                if self._model is None:
+                    self._model = WhisperModel(
+                        self.model_id,
+                        device=self.device,
+                        compute_type=self.compute_type,
+                    )
+        return self._model
+
+
+def build_api(holder: ModelHolder) -> FastAPI:
+    """Create the FastAPI app wired to the provided model holder."""
+    api = FastAPI(title="faster-whisper-api")
+
+    @api.get("/health")
+    def health() -> dict:
+        return {
+            "status": "ok",
+            "model": holder.model_id,
+            "device": holder.device,
+            "compute_type": holder.compute_type,
+        }
+
+    @api.post("/v1/audio/transcriptions")
+    async def transcribe(
+        file: Annotated[UploadFile, File(..., description="Audio file (wav, mp3, m4a, etc.)")],
+        language: str | None = None,
+    ) -> dict[str, str]:
+        audiobytes = await file.read()
+        if not audiobytes:
+            return JSONResponse({"error": "empty file"}, status_code=400)
+
+        with tempfile.NamedTemporaryFile(
+            delete=False,
+            suffix=Path(file.filename or "audio").suffix,
+        ) as tmp:
+            tmp.write(audiobytes)
+            tmp_path = tmp.name
+
+        try:
+            model = holder.get()
+            segments, info = model.transcribe(tmp_path, language=language)
+            text = " ".join(seg.text.strip() for seg in segments)
+            return {
+                "object": "transcription",
+                "model": holder.model_id,
+                "language": language or info.language,
+                "text": text,
+            }
+        finally:
+            Path(tmp_path).unlink(missing_ok=True)
+
+    return api
+
+
+def main(
+    model: str = typer.Option(DEFAULT_MODEL, help="faster-whisper model id"),
+    host: str = typer.Option(DEFAULT_HOST, show_default=True),
+    port: int = typer.Option(DEFAULT_PORT, show_default=True),
+    device: str = typer.Option(DEFAULT_DEVICE, help="cpu, cuda, or auto"),
+    compute_type: str = typer.Option(
+        DEFAULT_COMPUTE_TYPE,
+        help="faster-whisper compute_type (e.g., int8, int8_float16, float16, float32, default)",
+    ),
+    log_level: str = typer.Option(DEFAULT_LOG_LEVEL, help="uvicorn log level"),
+) -> None:
+    """Start the server with the given runtime options."""
+    holder = ModelHolder(model_id=model, device=device, compute_type=compute_type)
+    api = build_api(holder)
+    uvicorn.run(api, host=host, port=port, log_level=log_level)
+
+
+if __name__ == "__main__":
+    typer.run(main)

agent_cli/scripts/setup-linux-hotkeys.sh

@@ -0,0 +1,72 @@
+#!/usr/bin/env bash
+
+set -e
+
+echo "⌨️ Setting up Linux hotkeys..."
+
+# Check if we're on Linux
+if [[ "$(uname)" != "Linux" ]]; then
+    echo "❌ This script is for Linux only"
+    exit 1
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+TRANSCRIBE_SCRIPT="$SCRIPT_DIR/linux-hotkeys/toggle-transcription.sh"
+AUTOCORRECT_SCRIPT="$SCRIPT_DIR/linux-hotkeys/toggle-autocorrect.sh"
+VOICE_EDIT_SCRIPT="$SCRIPT_DIR/linux-hotkeys/toggle-voice-edit.sh"
+
+# Install notifications if missing
+echo "📢 Checking notifications..."
+if ! command -v notify-send &> /dev/null && ! command -v dunstify &> /dev/null; then
+    echo "📦 Installing notification support..."
+    if command -v apt &> /dev/null; then
+        sudo apt install -y libnotify-bin
+    elif command -v dnf &> /dev/null; then
+        sudo dnf install -y libnotify
+    elif command -v pacman &> /dev/null; then
+        sudo pacman -S --noconfirm libnotify
+    elif command -v zypper &> /dev/null; then
+        sudo zypper install -y libnotify-tools
+    else
+        echo "⚠️ Please install libnotify manually for your distribution"
+    fi
+fi
+
+# Test notifications
+if command -v notify-send &> /dev/null; then
+    notify-send "🎙️ Setup Complete" "Agent-CLI hotkeys ready!" || echo "⚠️ Notifications may not work in your environment"
+elif command -v dunstify &> /dev/null; then
+    dunstify "🎙️ Setup Complete" "Agent-CLI hotkeys ready!" || echo "⚠️ Notifications may not work in your environment"
+fi
+
+echo ""
+echo "✅ Scripts ready! Add these hotkeys to your desktop environment:"
+echo ""
+echo "📋 Hotkey Bindings:"
+echo "  Super+Shift+R → $TRANSCRIBE_SCRIPT"
+echo "  Super+Shift+A → $AUTOCORRECT_SCRIPT"
+echo "  Super+Shift+V → $VOICE_EDIT_SCRIPT"
+echo ""
+echo "🖥️ Configuration by Desktop Environment:"
+echo ""
+echo "Hyprland (~/.config/hypr/hyprland.conf):"
+echo "  bind = SUPER SHIFT, R, exec, $TRANSCRIBE_SCRIPT"
+echo "  bind = SUPER SHIFT, A, exec, $AUTOCORRECT_SCRIPT"
+echo "  bind = SUPER SHIFT, V, exec, $VOICE_EDIT_SCRIPT"
+echo ""
+echo "Sway (~/.config/sway/config):"
+echo "  bindsym \$mod+Shift+r exec $TRANSCRIBE_SCRIPT"
+echo "  bindsym \$mod+Shift+a exec $AUTOCORRECT_SCRIPT"
+echo "  bindsym \$mod+Shift+v exec $VOICE_EDIT_SCRIPT"
+echo ""
+echo "i3 (~/.config/i3/config):"
+echo "  bindsym \$mod+Shift+r exec --no-startup-id $TRANSCRIBE_SCRIPT"
+echo "  bindsym \$mod+Shift+a exec --no-startup-id $AUTOCORRECT_SCRIPT"
+echo "  bindsym \$mod+Shift+v exec --no-startup-id $VOICE_EDIT_SCRIPT"
+echo ""
+echo "GNOME: Settings → Keyboard → View and Customize Shortcuts → Custom Shortcuts"
+echo "KDE: System Settings → Shortcuts → Custom Shortcuts"
+echo "XFCE: Settings Manager → Keyboard → Application Shortcuts"
+echo ""
+echo "For other environments, bind Super+Shift+R/A/V to the respective scripts."

agent_cli/scripts/setup-linux.sh

@@ -0,0 +1,108 @@
+#!/usr/bin/env bash
+
+set -e
+
+echo "🚀 Setting up agent-cli services on Linux..."
+
+# Function to install uv based on the distribution
+install_uv() {
+    if command -v curl &> /dev/null; then
+        echo "📦 Installing uv using curl..."
+        curl -LsSf https://astral.sh/uv/install.sh | sh
+        # Add to PATH for current session
+        export PATH="$HOME/.local/bin:$PATH"
+    else
+        echo "curl not found. Please install curl first:"
+        echo "  Ubuntu/Debian: sudo apt install curl"
+        echo "  Fedora/RHEL: sudo dnf install curl"
+        exit 1
+    fi
+}
+
+# Check if uv is installed
+if ! command -v uv &> /dev/null; then
+    echo "📦 Installing uv..."
+    install_uv
+fi
+
+# Check for PortAudio (required for audio processing)
+echo "🔊 Checking PortAudio..."
+if ! pkg-config --exists portaudio-2.0 2>/dev/null; then
+    echo "❌ ERROR: PortAudio development libraries are not installed."
+    echo ""
+    echo "PyAudio requires PortAudio. Install using your distribution's package manager:"
+    echo ""
+    echo "Ubuntu/Debian:"
+    echo "  sudo apt install portaudio19-dev"
+    echo ""
+    echo "Fedora/RHEL/CentOS:"
+    echo "  sudo dnf install portaudio-devel"
+    echo ""
+    echo "Arch Linux:"
+    echo "  sudo pacman -S portaudio"
+    echo ""
+    echo "openSUSE:"
+    echo "  sudo zypper install portaudio-devel"
+    echo ""
+    echo "After installing PortAudio, run this script again."
+    exit 1
+else
+    echo "✅ PortAudio is already installed"
+fi
+
+# Install Ollama
+echo "🧠 Checking Ollama..."
+if ! command -v ollama &> /dev/null; then
+    echo "📦 Installing Ollama..."
+    curl -fsSL https://ollama.ai/install.sh | sh
+    echo "✅ Ollama installed successfully"
+else
+    echo "✅ Ollama is already installed"
+fi
+
+# Check if zellij is available or offer alternatives
+if ! command -v zellij &> /dev/null; then
+    echo "📺 Zellij not found. Installing..."
+
+    # Try different installation methods based on what's available
+    if command -v cargo &> /dev/null; then
+        echo "🦀 Installing zellij via cargo..."
+        cargo install zellij
+    elif command -v flatpak &> /dev/null; then
+        echo "📦 Installing zellij via flatpak..."
+        flatpak install -y flathub org.zellij_developers.zellij
+    else
+        echo "📥 Installing zellij binary..."
+        curl -L https://github.com/zellij-org/zellij/releases/latest/download/zellij-x86_64-unknown-linux-musl.tar.gz | tar -xz -C ~/.local/bin/
+        chmod +x ~/.local/bin/zellij
+        export PATH="$HOME/.local/bin:$PATH"
+    fi
+fi
+
+# Install agent-cli
+echo "🤖 Installing/upgrading agent-cli..."
+uv tool install --upgrade agent-cli
+
+# Preload default Ollama model
+echo "⬇️ Preloading default Ollama model (gemma3:4b)..."
+echo "⏳ This may take a few minutes depending on your internet connection..."
+# Start Ollama in background, then pull model synchronously
+(ollama serve >/dev/null 2>&1 &) && sleep 2 && ollama pull gemma3:4b
+# Stop the temporary ollama server
+pkill -f "ollama serve" || true
+
+echo ""
+echo "✅ Setup complete! You can now run the services:"
+echo ""
+echo "Option 1 - Run all services at once:"
+echo "  scripts/start-all-services.sh"
+echo ""
+echo "Option 2 - Run services individually:"
+echo "  1. Ollama: ollama serve"
+echo "  2. Whisper: scripts/run-whisper.sh"
+echo "  3. Piper: scripts/run-piper.sh"
+echo "  4. OpenWakeWord: scripts/run-openwakeword.sh"
+echo ""
+echo "📝 Note: Services use uvx to run without needing virtual environments."
+echo "For GPU acceleration, make sure NVIDIA drivers and CUDA are installed."
+echo "🎉 agent-cli has been installed and is ready to use!"

agent_cli/scripts/setup-macos-hotkeys.sh

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+
+set -e
+
+echo "⌨️ Setting up macOS hotkeys..."
+
+# Check macOS
+if [[ "$(uname)" != "Darwin" ]]; then
+    echo "❌ This script is for macOS only"
+    exit 1
+fi
+
+# Install dependencies
+echo "📦 Installing dependencies..."
+if ! command -v brew &> /dev/null; then
+    echo "🍺 Installing Homebrew..."
+    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+fi
+
+brew install terminal-notifier
+brew tap jackielii/tap && brew install jackielii/tap/skhd-zig
+
+# Setup configuration
+echo "⚙️ Setting up configuration..."
+mkdir -p ~/.config/skhd
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+TRANSCRIBE_SCRIPT="$SCRIPT_DIR/macos-hotkeys/toggle-transcription.sh"
+AUTOCORRECT_SCRIPT="$SCRIPT_DIR/macos-hotkeys/toggle-autocorrect.sh"
+VOICE_EDIT_SCRIPT="$SCRIPT_DIR/macos-hotkeys/toggle-voice-edit.sh"
+
+cat > ~/.config/skhd/skhdrc << EOF
+# Agent-CLI Hotkeys
+cmd + shift - r : "$TRANSCRIBE_SCRIPT"
+cmd + shift - a : "$AUTOCORRECT_SCRIPT"
+cmd + shift - v : "$VOICE_EDIT_SCRIPT"
+EOF
+
+# Start service
+echo "🚀 Starting skhd..."
+skhd --start-service
+
+# Test
+echo "🧪 Testing..."
+terminal-notifier -title "⌨️ Setup Complete" -message "Agent-CLI hotkeys ready!"
+
+echo ""
+echo "✅ Done! Hotkeys:"
+echo "  Cmd+Shift+R - Transcribe voice"
+echo "  Cmd+Shift+A - Autocorrect clipboard"
+echo "  Cmd+Shift+V - Voice edit clipboard"
+echo ""
+echo "If the hotkey doesn't work:"
+echo "1. Open System Settings → Privacy & Security → Accessibility"
+echo "2. Add and enable 'skhd'"
+echo ""
+echo "If the notification doesn't show:"
+echo "1. Open System Settings → Notifications"
+echo "2. Find 'terminal-notifier' and allow notifications"
+echo "3. Set Alert style to Persistent for better visibility"
+echo "4. Enable 'Allow notification when mirroring or sharing the display'"

agent_cli/scripts/setup-macos.sh

@@ -0,0 +1,76 @@
+#!/usr/bin/env bash
+
+set -e
+
+echo "🚀 Setting up agent-cli services on macOS..."
+
+# Check if Homebrew is installed
+if ! command -v brew &> /dev/null; then
+    echo "❌ Homebrew is not installed. Please install Homebrew first:"
+    echo "/bin/bash -c \"\$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\""
+    exit 1
+fi
+
+# Check if uv is installed
+if ! command -v uv &> /dev/null; then
+    echo "📦 Installing uv..."
+    brew install uv
+fi
+
+# Install Ollama
+echo "🧠 Checking Ollama..."
+if ! command -v ollama &> /dev/null; then
+    echo "🍺 Installing Ollama via Homebrew..."
+    brew install ollama
+    echo "✅ Ollama installed successfully"
+else
+    echo "✅ Ollama is already installed"
+fi
+
+# Check if zellij is installed
+if ! command -v zellij &> /dev/null; then
+    echo "📺 Installing zellij..."
+    brew install zellij
+fi
+
+# Install agent-cli
+echo "🤖 Installing/upgrading agent-cli..."
+uv tool install --upgrade agent-cli
+
+# Start Ollama as a background service
+echo "🧠 Starting Ollama as a background service..."
+brew services start ollama
+
+# Preload default Ollama model
+echo "⬇️ Preloading default Ollama model (gemma3:4b)..."
+echo "⏳ This may take a few minutes depending on your internet connection..."
+sleep 2  # Give Ollama service time to start
+ollama pull gemma3:4b
+
+# Install wyoming-mlx-whisper as a launchd service (Apple Silicon only)
+if [ "$(uname -m)" = "arm64" ]; then
+    echo "🎤 Installing wyoming-mlx-whisper as a background service..."
+    echo "   This will run speech-to-text on Apple Silicon using MLX"
+    curl -fsSL https://raw.githubusercontent.com/basnijholt/wyoming-mlx-whisper/main/scripts/install_service.sh | bash
+    echo "✅ wyoming-mlx-whisper installed as launchd service"
+else
+    echo "ℹ️ Skipping wyoming-mlx-whisper service (Intel Mac - use Linux-style setup)"
+fi
+
+echo ""
+echo "✅ Setup complete! You can now run the services:"
+echo ""
+echo "Option 1 - Run all services at once:"
+echo "  ./start-all-services.sh"
+echo ""
+echo "Option 2 - Run services individually:"
+echo "  1. Ollama: running as brew service (brew services start ollama)"
+if [ "$(uname -m)" = "arm64" ]; then
+    echo "  2. Whisper: running as launchd service (wyoming-mlx-whisper)"
+else
+    echo "  2. Whisper: ./run-whisper.sh"
+fi
+echo "  3. Piper: ./run-piper.sh"
+echo "  4. OpenWakeWord: ./run-openwakeword.sh"
+echo ""
+echo "🎉 agent-cli has been installed and is ready to use!"