agent-cli 0.70.5__py3-none-any.whl

agent_cli/scripts/setup-windows.ps1

@@ -0,0 +1,63 @@
+# PowerShell script to set up agent-cli services on Windows
+# Run with: powershell -ExecutionPolicy Bypass -File scripts/setup-windows.ps1
+
+$ErrorActionPreference = "Stop"
+
+Write-Host "🚀 Setting up agent-cli services on Windows..." -ForegroundColor Cyan
+
+# Create .runtime directory
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$RuntimeDir = Join-Path $ScriptDir ".runtime"
+if (-not (Test-Path $RuntimeDir)) {
+    New-Item -ItemType Directory -Path $RuntimeDir | Out-Null
+}
+
+# Check if uv is installed
+if (-not (Get-Command uv -ErrorAction SilentlyContinue)) {
+    Write-Host "📦 Installing uv..." -ForegroundColor Yellow
+    Invoke-RestMethod https://astral.sh/uv/install.ps1 | Invoke-Expression
+    # Refresh PATH
+    $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
+} else {
+    Write-Host "✅ uv is already installed" -ForegroundColor Green
+}
+
+# Check if Ollama is installed
+Write-Host "🧠 Checking Ollama..." -ForegroundColor Yellow
+if (-not (Get-Command ollama -ErrorAction SilentlyContinue)) {
+    Write-Host "📦 Ollama is not installed." -ForegroundColor Red
+    Write-Host ""
+    Write-Host "Please download and install Ollama from:" -ForegroundColor Yellow
+    Write-Host "  https://ollama.com/download/windows" -ForegroundColor Cyan
+    Write-Host ""
+    Write-Host "After installing, run this script again." -ForegroundColor Yellow
+    exit 1
+} else {
+    Write-Host "✅ Ollama is already installed" -ForegroundColor Green
+}
+
+# Install agent-cli
+Write-Host "🤖 Installing/upgrading agent-cli..." -ForegroundColor Yellow
+uv tool install --upgrade agent-cli
+
+# Preload default Ollama model
+Write-Host "⬇️ Preloading default Ollama model (gemma3:4b)..." -ForegroundColor Yellow
+Write-Host "⏳ This may take a few minutes depending on your internet connection..." -ForegroundColor Gray
+ollama pull gemma3:4b
+
+Write-Host ""
+Write-Host "✅ Setup complete!" -ForegroundColor Green
+Write-Host ""
+Write-Host "You can now run the services:" -ForegroundColor Cyan
+Write-Host ""
+Write-Host "Option 1 - Run all services at once:" -ForegroundColor White
+Write-Host "  .\scripts\start-all-services-windows.ps1" -ForegroundColor Gray
+Write-Host ""
+Write-Host "Option 2 - Run services individually:" -ForegroundColor White
+Write-Host "  1. Ollama: ollama serve  (or it runs automatically as a service)" -ForegroundColor Gray
+Write-Host "  2. Whisper: .\scripts\run-whisper-windows.ps1" -ForegroundColor Gray
+Write-Host "  3. Piper: .\scripts\run-piper-windows.ps1" -ForegroundColor Gray
+Write-Host ""
+Write-Host "📝 Note: Scripts use uvx to run without needing virtual environments." -ForegroundColor Yellow
+Write-Host "For GPU acceleration, make sure NVIDIA drivers and CUDA 12 are installed." -ForegroundColor Yellow
+Write-Host "🎉 agent-cli has been installed and is ready to use!" -ForegroundColor Green

agent_cli/scripts/start-all-services-windows.ps1

@@ -0,0 +1,53 @@
+# PowerShell script to start all agent-cli services on Windows
+# Run with: powershell -ExecutionPolicy Bypass -File scripts/start-all-services-windows.ps1
+
+$ErrorActionPreference = "Stop"
+
+Write-Host "🚀 Starting all agent-cli services..." -ForegroundColor Cyan
+
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+
+# Check if Windows Terminal is available for a nicer experience
+$UseWindowsTerminal = $false
+if (Get-Command wt -ErrorAction SilentlyContinue) {
+    $UseWindowsTerminal = $true
+}
+
+if ($UseWindowsTerminal) {
+    Write-Host "📺 Using Windows Terminal for multi-tab view..." -ForegroundColor Green
+
+    # Start Windows Terminal with multiple tabs
+    wt --title "agent-cli services" `
+        new-tab --title "Ollama" powershell -NoExit -Command "ollama serve" `; `
+        new-tab --title "Whisper" powershell -NoExit -ExecutionPolicy Bypass -File "$ScriptDir\run-whisper-windows.ps1" `; `
+        new-tab --title "Piper" powershell -NoExit -ExecutionPolicy Bypass -File "$ScriptDir\run-piper-windows.ps1"
+
+    Write-Host ""
+    Write-Host "✅ Services started in Windows Terminal tabs!" -ForegroundColor Green
+    Write-Host ""
+    Write-Host "📝 Tips:" -ForegroundColor Yellow
+    Write-Host "  - Switch tabs with Ctrl+Tab" -ForegroundColor Gray
+    Write-Host "  - Close all: Close the Windows Terminal window" -ForegroundColor Gray
+} else {
+    Write-Host "📺 Opening services in separate PowerShell windows..." -ForegroundColor Yellow
+
+    # Start each service in a new PowerShell window
+    Start-Process powershell -ArgumentList "-NoExit", "-Command", "Write-Host 'Ollama' -ForegroundColor Cyan; ollama serve"
+    Start-Process powershell -ArgumentList "-NoExit", "-ExecutionPolicy", "Bypass", "-File", "$ScriptDir\run-whisper-windows.ps1"
+    Start-Process powershell -ArgumentList "-NoExit", "-ExecutionPolicy", "Bypass", "-File", "$ScriptDir\run-piper-windows.ps1"
+
+    Write-Host ""
+    Write-Host "✅ Services started in separate windows!" -ForegroundColor Green
+    Write-Host ""
+    Write-Host "📝 Note: Install Windows Terminal for a better multi-tab experience:" -ForegroundColor Yellow
+    Write-Host "  winget install Microsoft.WindowsTerminal" -ForegroundColor Gray
+}
+
+Write-Host ""
+Write-Host "🔌 Service ports:" -ForegroundColor Cyan
+Write-Host "  - Ollama:  http://localhost:11434" -ForegroundColor Gray
+Write-Host "  - Whisper: tcp://localhost:10300" -ForegroundColor Gray
+Write-Host "  - Piper:   tcp://localhost:10200" -ForegroundColor Gray
+Write-Host ""
+Write-Host "🎉 You can now use agent-cli!" -ForegroundColor Green
+Write-Host "  agent-cli transcribe" -ForegroundColor Gray

agent_cli/scripts/start-all-services.sh

@@ -0,0 +1,178 @@
+#!/usr/bin/env bash
+
+# Check if zellij is installed
+if ! command -v zellij &> /dev/null; then
+    echo "📺 Zellij not found. Installing..."
+    uvx dotbins get zellij-org/zellij
+    export PATH="$HOME/.local/bin:$PATH"
+fi
+
+# Get the current directory
+SCRIPTS_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+# Help text for zellij panes
+HELP_TEXT='╔═══════════════════════════════════════════════════════════════════╗
+║                    Agent CLI Services                             ║
+╠═══════════════════════════════════════════════════════════════════╣
+║                                                                   ║
+║  🔴 IMPORTANT:                                                    ║
+║  • Ctrl-O d  → Detach (keeps services running in background!)     ║
+║  • Ctrl-Q    → Quit (STOPS all services!)                         ║
+║                                                                   ║
+║  To reattach later: $ zellij attach agent-cli                     ║
+║                                                                   ║
+╠═══════════════════════════════════════════════════════════════════╣
+║                                                                   ║
+║  Services Running:                                                ║
+║  • Ollama (LLM) - Port 11434                                      ║
+║  • Whisper (STT) - Port 10300                                     ║
+║  • Piper (TTS) - Port 10200                                       ║
+║  • OpenWakeWord - Port 10400                                      ║
+║                                                                   ║
+║  Navigation:                                                      ║
+║  • Alt + ← → ↑ ↓  - Move between panes                            ║
+║  • Ctrl-F         - Toggle this help                              ║
+║  • q              - Close this help                               ║
+║                                                                   ║
+╚═══════════════════════════════════════════════════════════════════╝'
+
+# On macOS, check if services are running via brew/launchd
+OLLAMA_BREW_SERVICE=false
+WHISPER_LAUNCHD=false
+if [ "$(uname -s)" = "Darwin" ]; then
+    # Check if Ollama is running as a brew service
+    if launchctl list homebrew.mxcl.ollama &>/dev/null; then
+        OLLAMA_BREW_SERVICE=true
+    fi
+    # Check if Whisper is running as a launchd service (ARM only)
+    if [ "$(uname -m)" = "arm64" ]; then
+        if launchctl list com.wyoming_mlx_whisper &>/dev/null; then
+            WHISPER_LAUNCHD=true
+        fi
+    fi
+fi
+
+# Create .runtime directory
+mkdir -p "$SCRIPTS_DIR/.runtime"
+
+# Generate Ollama pane based on whether brew service is running
+if [ "$OLLAMA_BREW_SERVICE" = true ]; then
+    OLLAMA_PANE="            pane {
+                name \"Ollama (brew service)\"
+                command \"sh\"
+                args \"-c\" \"echo '🧠 Ollama is running as a brew background service'; echo ''; echo 'To view status:'; echo '  brew services info ollama'; echo ''; echo 'To stop:'; echo '  brew services stop ollama'; echo ''; echo 'To restart:'; echo '  brew services restart ollama'; echo ''; read -r\"
+            }"
+else
+    OLLAMA_PANE="            pane {
+                name \"Ollama\"
+                command \"ollama\"
+                args \"serve\"
+            }"
+fi
+
+# Generate Whisper pane command based on whether launchd service is running
+if [ "$WHISPER_LAUNCHD" = true ]; then
+    WHISPER_PANE="            pane {
+                name \"Whisper (launchd)\"
+                command \"sh\"
+                args \"-c\" \"echo '🎤 Whisper is running as a background launchd service'; echo ''; echo 'Service: com.wyoming_mlx_whisper'; echo 'Logs: ~/Library/Logs/wyoming-mlx-whisper/'; echo ''; echo 'To view logs:'; echo '  tail -f ~/Library/Logs/wyoming-mlx-whisper/wyoming-mlx-whisper.out'; echo ''; echo 'To uninstall:'; echo '  curl -fsSL https://raw.githubusercontent.com/basnijholt/wyoming-mlx-whisper/main/scripts/uninstall_service.sh | bash'; echo ''; read -r\"
+            }"
+else
+    WHISPER_PANE="            pane {
+                name \"Whisper\"
+                cwd \"$SCRIPTS_DIR\"
+                command \"./run-whisper.sh\"
+            }"
+fi
+
+BOTTOM_PANES="        pane split_direction=\"horizontal\" {
+$WHISPER_PANE
+            pane split_direction=\"horizontal\" {
+                pane {
+                    name \"Piper\"
+                    cwd \"$SCRIPTS_DIR\"
+                    command \"./run-piper.sh\"
+                }
+                pane {
+                    name \"OpenWakeWord\"
+                    cwd \"$SCRIPTS_DIR\"
+                    command \"./run-openwakeword.sh\"
+                }
+            }
+        }"
+
+TOP_PANES="        pane split_direction=\"horizontal\" {
+$OLLAMA_PANE
+            pane {
+                name \"Help\"
+                command \"sh\"
+                args \"-c\" \"echo '$HELP_TEXT' | less\"
+            }
+        }"
+
+cat > "$SCRIPTS_DIR/.runtime/agent-cli-layout.kdl" << EOF
+session_name "agent-cli"
+
+layout {
+    pane split_direction="vertical" {
+$TOP_PANES
+$BOTTOM_PANES
+    }
+
+    floating_panes {
+        pane {
+            name "Help"
+            x "10%"
+            y "10%"
+            width "80%"
+            height "80%"
+            command "sh"
+            close_on_exit true
+            args "-c" "echo '$HELP_TEXT' | less"
+        }
+    }
+}
+EOF
+
+# Function to show common usage instructions
+show_usage() {
+    echo "❌ Use 'Ctrl-Q' to quit Zellij"
+    echo "🔌 Use 'Ctrl-O d' to detach from the session"
+    echo "🔗 Use 'zellij attach agent-cli' to reattach"
+}
+
+# Function to start a new Zellij session
+start_new_session() {
+    if [ "$AGENT_CLI_NO_ATTACH" = "true" ]; then
+        # Start detached
+        zellij --session agent-cli --layout "$SCRIPTS_DIR/.runtime/agent-cli-layout.kdl" &
+        sleep 1  # Give it a moment to start
+        echo "✅ Session 'agent-cli' started in background. Use 'zellij attach agent-cli' to view."
+    else
+        show_usage
+        # Start zellij with layout file - session name is specified in the layout
+        zellij --layout "$SCRIPTS_DIR/.runtime/agent-cli-layout.kdl"
+    fi
+}
+
+# Check if agent-cli session already exists and is running
+# Case 1: Session exists but has exited - clean it up and start fresh
+if zellij list-sessions 2>/dev/null | grep "agent-cli" | grep -q "EXITED"; then
+    echo "🧹 Found exited session 'agent-cli'. Cleaning up..."
+    zellij delete-session agent-cli
+    echo "🆕 Starting fresh services in Zellij..."
+    start_new_session
+# Case 2: Session exists and is running - attach to it if requested
+elif zellij list-sessions 2>/dev/null | grep -q "agent-cli"; then
+    if [ "$AGENT_CLI_NO_ATTACH" = "true" ]; then
+        echo "✅ Session 'agent-cli' is already running. Not attaching as requested."
+    else
+        echo "🔗 Session 'agent-cli' already exists and is running. Attaching..."
+        show_usage
+        zellij attach agent-cli
+    fi
+# Case 3: No session exists - create a new one
+else
+    echo "🚀 Starting all services in Zellij..."
+    start_new_session
+fi

agent_cli/scripts/sync_extras.py

@@ -0,0 +1,138 @@
+#!/usr/bin/env python3
+"""Generate _extras.json from pyproject.toml.
+
+This script parses the optional-dependencies in pyproject.toml and generates
+the agent_cli/_extras.json file with package-to-import mappings.
+
+Usage:
+    python scripts/sync_extras.py
+"""
+
+from __future__ import annotations
+
+import json
+import re
+import sys
+import tomllib
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).parent.parent
+PYPROJECT = REPO_ROOT / "pyproject.toml"
+EXTRAS_FILE = REPO_ROOT / "agent_cli" / "_extras.json"
+
+# Extras to skip (dev/test dependencies, not runtime installable)
+SKIP_EXTRAS = {"dev", "test"}
+
+# Manual mapping of extra name -> (description, list of import names)
+# Import names should be the Python module name (how you import it)
+# Bundle extras (voice, cloud, full) have empty import lists since they just install other extras
+EXTRA_METADATA: dict[str, tuple[str, list[str]]] = {
+    # Provider extras (base dependencies now optional)
+    "audio": ("Audio recording/playback", ["sounddevice"]),
+    "wyoming": ("Wyoming protocol support", ["wyoming"]),
+    "openai": ("OpenAI API provider", ["openai"]),
+    "gemini": ("Google Gemini provider", ["google.genai"]),
+    "llm": ("LLM framework (pydantic-ai)", ["pydantic_ai"]),
+    # Feature extras
+    "rag": ("RAG proxy (ChromaDB, embeddings)", ["chromadb"]),
+    "memory": ("Long-term memory proxy", ["chromadb", "yaml"]),
+    "vad": ("Voice Activity Detection (silero-vad)", ["silero_vad"]),
+    "whisper": ("Local Whisper ASR (faster-whisper)", ["faster_whisper"]),
+    "whisper-mlx": ("MLX Whisper for Apple Silicon", ["mlx_whisper"]),
+    "tts": ("Local Piper TTS", ["piper"]),
+    "tts-kokoro": ("Kokoro neural TTS", ["kokoro"]),
+    "server": ("FastAPI server components", ["fastapi"]),
+    "speed": ("Audio speed adjustment (audiostretchy)", ["audiostretchy"]),
+}
+
+
+def get_extras_from_pyproject() -> set[str]:
+    """Parse optional-dependencies from pyproject.toml."""
+    with PYPROJECT.open("rb") as f:
+        data = tomllib.load(f)
+    all_extras = set(data.get("project", {}).get("optional-dependencies", {}).keys())
+    return all_extras - SKIP_EXTRAS
+
+
+def extract_package_name(dep: str) -> str:
+    """Extract the package name from a dependency specification.
+
+    Examples:
+        "chromadb>=0.4.22" -> "chromadb"
+        "pydantic-ai-slim[openai,duckduckgo]" -> "pydantic-ai-slim"
+        'mlx-whisper>=0.4.0; sys_platform == "darwin"' -> "mlx-whisper"
+
+    """
+    # Remove markers (;...) and extras ([...])
+    dep = re.split(r"[;\[]", dep)[0]
+    # Remove version specifiers
+    dep = re.split(r"[<>=!~]", dep)[0]
+    return dep.strip()
+
+
+def package_to_import_name(package: str) -> str:
+    """Convert a package name to its Python import name.
+
+    Examples:
+        "google-genai" -> "google.genai"
+        "pydantic-ai-slim" -> "pydantic_ai"
+        "silero-vad" -> "silero_vad"
+        "faster-whisper" -> "faster_whisper"
+
+    """
+    # Special cases where the import name differs significantly
+    special_cases = {
+        "google-genai": "google.genai",
+        "pydantic-ai-slim": "pydantic_ai",
+        "silero-vad": "silero_vad",
+        "faster-whisper": "faster_whisper",
+        "mlx-whisper": "mlx_whisper",
+        "piper-tts": "piper",
+        "huggingface-hub": "huggingface_hub",
+        "fastapi": "fastapi",
+        "audiostretchy": "audiostretchy",
+    }
+    if package in special_cases:
+        return special_cases[package]
+    # Default: replace hyphens with underscores
+    return package.replace("-", "_")
+
+
+def generate_extras_json(extras: set[str]) -> dict[str, list]:
+    """Generate the content for _extras.json."""
+    result = {}
+    for extra in sorted(extras):
+        if extra in EXTRA_METADATA:
+            desc, imports = EXTRA_METADATA[extra]
+            result[extra] = [desc, imports]
+        else:
+            # Unknown extra - add a placeholder
+            result[extra] = ["TODO: add description", []]
+    return result
+
+
+def check_missing_metadata(extras: set[str]) -> list[str]:
+    """Check for extras that don't have metadata defined."""
+    return [e for e in extras if e not in EXTRA_METADATA]
+
+
+def main() -> int:
+    """Generate _extras.json from pyproject.toml."""
+    extras = get_extras_from_pyproject()
+
+    # Check for missing metadata
+    missing = check_missing_metadata(extras)
+    if missing:
+        print(f"Warning: The following extras need metadata in EXTRA_METADATA: {missing}")
+        print("Please update EXTRA_METADATA in scripts/sync_extras.py")
+
+    # Generate the file
+    content = generate_extras_json(extras)
+    EXTRAS_FILE.write_text(json.dumps(content, indent=2) + "\n")
+    print(f"Generated {EXTRAS_FILE}")
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

agent_cli/server/__init__.py

@@ -0,0 +1,3 @@
+"""Server module for agent-cli."""
+
+from __future__ import annotations