superlocalmemory 2.8.5 → 3.0.0

package/scripts/install-skills.ps1

@@ -0,0 +1,334 @@
+# SuperLocalMemory V2 - Universal Skills Installer (PowerShell)
+# Installs skills for Claude Code, Codex, Gemini CLI, Antigravity, and Windsurf
+
+param(
+    [switch]$Auto
+)
+
+$ErrorActionPreference = "Stop"
+
+# Configuration
+$REPO_DIR = $PSScriptRoot
+$SKILLS_SOURCE = Join-Path $REPO_DIR "skills"
+
+# Tool definitions
+$TOOL_IDS = @("claude_code", "codex", "gemini_cli", "antigravity", "windsurf", "cursor", "vscode_copilot")
+$TOOL_NAMES = @("Claude Code", "Codex", "Gemini CLI", "Antigravity", "Windsurf", "Cursor", "VS Code/Copilot")
+$TOOL_DIRS = @(
+    (Join-Path $env:USERPROFILE ".claude\skills"),
+    (Join-Path $env:USERPROFILE ".codex\skills"),
+    (Join-Path $env:USERPROFILE ".gemini\skills"),
+    (Join-Path $env:USERPROFILE ".gemini\antigravity\skills"),
+    (Join-Path $env:USERPROFILE ".windsurf\skills"),
+    (Join-Path $env:USERPROFILE ".cursor\skills"),
+    (Join-Path $env:USERPROFILE ".copilot\skills")
+)
+
+# Helper functions
+function Get-ToolName {
+    param([string]$ToolId)
+    $index = $TOOL_IDS.IndexOf($ToolId)
+    if ($index -ge 0) { return $TOOL_NAMES[$index] }
+    return $ToolId
+}
+
+function Get-ToolDir {
+    param([string]$ToolId)
+    $index = $TOOL_IDS.IndexOf($ToolId)
+    if ($index -ge 0) { return $TOOL_DIRS[$index] }
+    return ""
+}
+
+# Skills to install
+$SKILLS = @(
+    "slm-remember",
+    "slm-recall",
+    "slm-status",
+    "slm-list-recent",
+    "slm-build-graph",
+    "slm-switch-profile"
+)
+
+Write-Host "=========================================="
+Write-Host "SuperLocalMemory V2 - Universal Skills Installer"
+Write-Host "=========================================="
+Write-Host ""
+
+# Check if SuperLocalMemory V2 is installed
+$memoryDir = Join-Path $env:USERPROFILE ".claude-memory"
+if (-not (Test-Path $memoryDir)) {
+    Write-Host "Warning: SuperLocalMemory V2 not found at $memoryDir" -ForegroundColor Yellow
+    Write-Host "Skills require SuperLocalMemory V2 to be installed first."
+    Write-Host ""
+    if (-not $Auto) {
+        $response = Read-Host "Do you want to continue anyway? (y/n)"
+        if ($response -ne "y" -and $response -ne "Y") {
+            Write-Host "Installation cancelled."
+            Write-Host "Please install SuperLocalMemory V2 first: .\install.ps1"
+            exit 1
+        }
+    } else {
+        Write-Host "Auto mode: continuing anyway..."
+    }
+}
+
+# Check if skills source directory exists
+if (-not (Test-Path $SKILLS_SOURCE)) {
+    Write-Host "Error: Skills directory not found: $SKILLS_SOURCE" -ForegroundColor Red
+    Write-Host "Please run this script from the SuperLocalMemoryV2-repo directory."
+    exit 1
+}
+
+# Verify all skill directories exist
+Write-Host "Verifying skill files..."
+$MISSING_SKILLS = 0
+foreach ($skill in $SKILLS) {
+    $skillDir = Join-Path $SKILLS_SOURCE $skill
+    $skillFile = Join-Path $skillDir "SKILL.md"
+    if (-not (Test-Path $skillDir)) {
+        Write-Host "✗ Missing: $skill/" -ForegroundColor Red
+        $MISSING_SKILLS++
+    } elseif (-not (Test-Path $skillFile)) {
+        Write-Host "✗ Missing: $skill/SKILL.md" -ForegroundColor Red
+        $MISSING_SKILLS++
+    } else {
+        Write-Host "✓ Found: $skill/SKILL.md" -ForegroundColor Green
+    }
+}
+
+if ($MISSING_SKILLS -gt 0) {
+    Write-Host "Error: $MISSING_SKILLS skill(s) missing. Cannot proceed." -ForegroundColor Red
+    exit 1
+}
+
+Write-Host ""
+Write-Host "Found $($SKILLS.Count) skills to install"
+Write-Host ""
+
+# Detect available tools
+Write-Host "=========================================="
+Write-Host "Detecting AI Tools"
+Write-Host "=========================================="
+Write-Host ""
+
+$DETECTED_TOOLS = @()
+
+for ($i = 0; $i -lt $TOOL_IDS.Count; $i++) {
+    $toolId = $TOOL_IDS[$i]
+    $toolName = $TOOL_NAMES[$i]
+    $toolDir = $TOOL_DIRS[$i]
+    $parentDir = Split-Path $toolDir -Parent
+
+    if (Test-Path $parentDir) {
+        Write-Host "✓ $toolName detected: $toolDir" -ForegroundColor Green
+        $DETECTED_TOOLS += $toolId
+    } else {
+        Write-Host "○ $toolName not found: $parentDir" -ForegroundColor Blue
+    }
+}
+
+Write-Host ""
+
+if ($DETECTED_TOOLS.Count -eq 0) {
+    if ($Auto) {
+        Write-Host "Warning: No supported AI tools detected. Skipping skills installation." -ForegroundColor Yellow
+        Write-Host ""
+        exit 0
+    }
+    Write-Host "Warning: No supported AI tools detected." -ForegroundColor Yellow
+    Write-Host ""
+    Write-Host "Supported tools:"
+    for ($i = 0; $i -lt $TOOL_IDS.Count; $i++) {
+        Write-Host "  - $($TOOL_NAMES[$i]): $($TOOL_DIRS[$i])"
+    }
+    Write-Host ""
+    $response = Read-Host "Do you want to continue and create directories anyway? (y/n)"
+    if ($response -ne "y" -and $response -ne "Y") {
+        Write-Host "Installation cancelled."
+        exit 1
+    }
+    # Add all tools to install list
+    $DETECTED_TOOLS = $TOOL_IDS
+} else {
+    Write-Host "Will install skills for $($DETECTED_TOOLS.Count) tool(s)"
+    Write-Host ""
+}
+
+# Ask user for installation method
+if ($Auto) {
+    $METHOD = "copy"  # Windows: copy is more reliable than symlink
+    Write-Host "Auto mode: Using copy method..."
+} else {
+    Write-Host "Installation Methods:"
+    Write-Host "  1. Copy - Stable, requires manual updates (recommended for Windows)"
+    Write-Host "  2. Symlink - Changes in repo reflect immediately (requires admin on Windows)"
+    Write-Host ""
+    $choice = Read-Host "Choose installation method (1 or 2)"
+    Write-Host ""
+
+    if ($choice -eq "1") {
+        $METHOD = "copy"
+        Write-Host "Installing via copy..."
+    } elseif ($choice -eq "2") {
+        $METHOD = "symlink"
+        Write-Host "Installing via symlink..."
+    } else {
+        Write-Host "Invalid choice. Please enter 1 or 2." -ForegroundColor Red
+        exit 1
+    }
+}
+
+Write-Host ""
+
+# Install skills for each detected tool
+$TOTAL_INSTALLED = 0
+$TOTAL_FAILED = 0
+$TOTAL_SKIPPED = 0
+
+foreach ($toolId in $DETECTED_TOOLS) {
+    $toolName = Get-ToolName $toolId
+    Write-Host "=========================================="
+    Write-Host "Installing for: $toolName"
+    Write-Host "=========================================="
+
+    $skillsDir = Get-ToolDir $toolId
+
+    # Create skills directory if it doesn't exist
+    if (-not (Test-Path $skillsDir)) {
+        Write-Host "Creating directory: $skillsDir"
+        try {
+            New-Item -ItemType Directory -Path $skillsDir -Force | Out-Null
+            Write-Host "✓ Directory created" -ForegroundColor Green
+        } catch {
+            Write-Host "✗ Failed to create directory" -ForegroundColor Red
+            Write-Host ""
+            $TOTAL_SKIPPED += $SKILLS.Count
+            continue
+        }
+    } else {
+        Write-Host "Directory exists: $skillsDir"
+    }
+
+    Write-Host ""
+
+    # Install each skill
+    foreach ($skill in $SKILLS) {
+        $sourceFile = Join-Path (Join-Path $SKILLS_SOURCE $skill) "SKILL.md"
+        $targetFile = Join-Path $skillsDir "$skill.md"
+
+        # Remove existing file or symlink
+        if (Test-Path $targetFile) {
+            Remove-Item $targetFile -Force
+        }
+
+        try {
+            if ($METHOD -eq "symlink") {
+                # Create symlink (requires admin on Windows)
+                New-Item -ItemType SymbolicLink -Path $targetFile -Target $sourceFile -Force | Out-Null
+                Write-Host "✓ Symlinked: $skill.md" -ForegroundColor Green
+                $TOTAL_INSTALLED++
+            } else {
+                # Copy file
+                Copy-Item $sourceFile -Destination $targetFile -Force
+                Write-Host "✓ Copied: $skill.md" -ForegroundColor Green
+                $TOTAL_INSTALLED++
+            }
+        } catch {
+            Write-Host "✗ Failed to install: $skill.md - $($_.Exception.Message)" -ForegroundColor Red
+            $TOTAL_FAILED++
+        }
+    }
+
+    Write-Host ""
+}
+
+# Installation Summary
+Write-Host "=========================================="
+Write-Host "Installation Summary"
+Write-Host "=========================================="
+Write-Host ""
+Write-Host "Tools configured: $($DETECTED_TOOLS.Count)" -ForegroundColor Blue
+Write-Host "Skills installed: $TOTAL_INSTALLED" -ForegroundColor Green
+if ($TOTAL_FAILED -gt 0) {
+    Write-Host "Failed: $TOTAL_FAILED" -ForegroundColor Red
+}
+if ($TOTAL_SKIPPED -gt 0) {
+    Write-Host "Skipped: $TOTAL_SKIPPED" -ForegroundColor Yellow
+}
+Write-Host "Installation method: $METHOD"
+Write-Host ""
+
+# List installation locations
+Write-Host "Skills installed to:"
+foreach ($toolId in $DETECTED_TOOLS) {
+    $toolName = Get-ToolName $toolId
+    $toolDir = Get-ToolDir $toolId
+    if ((Test-Path $toolDir) -and ((Get-ChildItem -Path $toolDir -Filter "*.md" -ErrorAction SilentlyContinue).Count -gt 0)) {
+        $count = (Get-ChildItem -Path $toolDir -Filter "*.md").Count
+        Write-Host "  ✓ $toolName`: $toolDir ($count skills)" -ForegroundColor Green
+    }
+}
+
+Write-Host ""
+
+# Verify installation
+$EXPECTED_TOTAL = $DETECTED_TOOLS.Count * $SKILLS.Count
+if ($TOTAL_INSTALLED -eq $EXPECTED_TOTAL) {
+    Write-Host "✓ All skills installed successfully!" -ForegroundColor Green
+} else {
+    Write-Host "⚠ Some skills failed to install." -ForegroundColor Yellow
+    Write-Host "Expected: $EXPECTED_TOTAL, Installed: $TOTAL_INSTALLED"
+}
+
+Write-Host ""
+
+# List available skills
+Write-Host "=========================================="
+Write-Host "Available Skills"
+Write-Host "=========================================="
+Write-Host ""
+foreach ($skill in $SKILLS) {
+    Write-Host "  • $skill"
+}
+Write-Host ""
+
+# Next Steps
+Write-Host "=========================================="
+Write-Host "Next Steps"
+Write-Host "=========================================="
+Write-Host ""
+Write-Host "1. Restart your AI tool to load the new skills" -ForegroundColor Yellow
+Write-Host ""
+Write-Host "2. Verify skills are loaded:"
+foreach ($toolId in $DETECTED_TOOLS) {
+    $toolName = Get-ToolName $toolId
+    Write-Host "   $toolName (check available commands/skills)" -ForegroundColor Green
+}
+Write-Host ""
+Write-Host "3. Try your first skill:"
+Write-Host "   /slm-status or /slm-remember `"test`"" -ForegroundColor Green
+Write-Host ""
+Write-Host "4. Read skill documentation:"
+Write-Host "   Each skill has detailed docs in: $SKILLS_SOURCE\<skill-name>\SKILL.md"
+Write-Host ""
+
+if ($METHOD -eq "copy") {
+    Write-Host "Note: Using copies. To update skills:"
+    Write-Host "  cd $REPO_DIR"
+    Write-Host "  git pull"
+    Write-Host "  .\install-skills.ps1"
+    Write-Host ""
+}
+
+Write-Host "=========================================="
+Write-Host ""
+Write-Host "✓ Universal skills installation complete!" -ForegroundColor Green
+Write-Host ""
+Write-Host "Skills installed for:"
+foreach ($toolId in $DETECTED_TOOLS) {
+    Write-Host "  • $(Get-ToolName $toolId)"
+}
+Write-Host ""
+Write-Host "Remember: Skills are OPTIONAL convenience wrappers."
+Write-Host "SuperLocalMemory V2 works standalone via terminal commands."
+Write-Host ""

package/{install.ps1 → scripts/install.ps1}

@@ -15,7 +15,7 @@ param(
 
 $ErrorActionPreference = "Stop"
 
-$INSTALL_DIR = Join-Path $env:USERPROFILE ".claude-memory"
+$INSTALL_DIR = if ($env:SL_MEMORY_PATH) { $env:SL_MEMORY_PATH } else { Join-Path $env:USERPROFILE ".claude-memory" }
 $REPO_DIR = Split-Path -Parent $MyInvocation.MyCommand.Path
 
 # Auto-detect non-interactive environment
@@ -122,6 +122,35 @@ if (Test-Path $uiServerPath) {
     Write-Host "OK UI server copied" -ForegroundColor Green
 }
 
+# Copy security middleware (required by ui_server.py)
+$securityMiddlewarePath = Join-Path $REPO_DIR "security_middleware.py"
+if (Test-Path $securityMiddlewarePath) {
+    Copy-Item -Path $securityMiddlewarePath -Destination $INSTALL_DIR -Force
+    Write-Host "OK Security middleware copied" -ForegroundColor Green
+}
+
+# Copy routes (required by ui_server.py)
+$routesDir = Join-Path $REPO_DIR "routes"
+$installRoutesDir = Join-Path $INSTALL_DIR "routes"
+if (Test-Path $routesDir) {
+    if (-not (Test-Path $installRoutesDir)) {
+        New-Item -ItemType Directory -Path $installRoutesDir -Force | Out-Null
+    }
+    Copy-Item -Path (Join-Path $routesDir "*") -Destination $installRoutesDir -Recurse -Force
+    Write-Host "OK Routes copied" -ForegroundColor Green
+}
+
+# Copy UI assets (required by ui_server.py)
+$uiDir = Join-Path $REPO_DIR "ui"
+$installUiDir = Join-Path $INSTALL_DIR "ui"
+if (Test-Path $uiDir) {
+    if (-not (Test-Path $installUiDir)) {
+        New-Item -ItemType Directory -Path $installUiDir -Force | Out-Null
+    }
+    Copy-Item -Path (Join-Path $uiDir "*") -Destination $installUiDir -Recurse -Force
+    Write-Host "OK UI assets copied" -ForegroundColor Green
+}
+
 # Copy MCP server
 $mcpServerPath = Join-Path $REPO_DIR "mcp_server.py"
 if (Test-Path $mcpServerPath) {
@@ -169,8 +198,9 @@ if (Test-Path $setupValidatorPath) {
         # Fallback: create basic database
         & python -c @"
 import sqlite3
+import os
 from pathlib import Path
-db_path = Path.home() / '.claude-memory' / 'memory.db'
+db_path = Path(os.environ.get('SL_MEMORY_PATH') or str(Path.home() / '.claude-memory')) / 'memory.db'
 conn = sqlite3.connect(db_path)
 cursor = conn.cursor()
 cursor.execute('''CREATE TABLE IF NOT EXISTS memories (
@@ -228,8 +258,9 @@ Write-Host "Initializing advanced features..."
 # Add sample memories if database is empty (for first-time users)
 $memoryCount = & python -c @"
 import sqlite3
+import os
 from pathlib import Path
-db_path = Path.home() / '.claude-memory' / 'memory.db'
+db_path = Path(os.environ.get('SL_MEMORY_PATH') or str(Path.home() / '.claude-memory')) / 'memory.db'
 conn = sqlite3.connect(db_path)
 cursor = conn.cursor()
 cursor.execute('SELECT COUNT(*) FROM memories')
@@ -261,8 +292,9 @@ try {
     & python "$INSTALL_DIR\pattern_learner.py" update 2>$null | Out-Null
     $patternCount = & python -c @"
 import sqlite3
+import os
 from pathlib import Path
-db_path = Path.home() / '.claude-memory' / 'memory.db'
+db_path = Path(os.environ.get('SL_MEMORY_PATH') or str(Path.home() / '.claude-memory')) / 'memory.db'
 conn = sqlite3.connect(db_path)
 cursor = conn.cursor()
 cursor.execute('SELECT COUNT(*) FROM identity_patterns')

package/{install.sh → scripts/install.sh}

@@ -8,7 +8,7 @@
 
 set -e
 
-INSTALL_DIR="${HOME}/.claude-memory"
+INSTALL_DIR="${SL_MEMORY_PATH:-${HOME}/.claude-memory}"
 REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
 
 # Parse command line arguments
@@ -214,6 +214,11 @@ if [ -f "${REPO_DIR}/ui_server.py" ]; then
     echo "✓ UI server copied"
 fi
 
+if [ -f "${REPO_DIR}/security_middleware.py" ]; then
+    cp "${REPO_DIR}/security_middleware.py" "${INSTALL_DIR}/"
+    echo "✓ Security middleware copied"
+fi
+
 if [ -d "${REPO_DIR}/ui" ]; then
     mkdir -p "${INSTALL_DIR}/ui/js"
     cp "${REPO_DIR}/ui/index.html" "${INSTALL_DIR}/ui/" 2>/dev/null || true
@@ -258,8 +263,7 @@ echo "✓ Directories created"
 if [ ! -f "${INSTALL_DIR}/audit.db" ]; then
     python3 -c "
 import sqlite3
-from pathlib import Path
-audit_path = Path.home() / '.claude-memory' / 'audit.db'
+audit_path = '${INSTALL_DIR}/audit.db'
 conn = sqlite3.connect(audit_path)
 cursor = conn.cursor()
 cursor.execute('''CREATE TABLE IF NOT EXISTS audit_events (
@@ -298,8 +302,7 @@ else
     # Fallback: create basic tables
     python3 -c "
 import sqlite3
-from pathlib import Path
-db_path = Path.home() / '.claude-memory' / 'memory.db'
+db_path = '${INSTALL_DIR}/memory.db'
 conn = sqlite3.connect(db_path)
 cursor = conn.cursor()
 cursor.execute('''CREATE TABLE IF NOT EXISTS memories (
@@ -399,8 +402,7 @@ echo "Initializing advanced features..."
 # Add sample memories if database is empty (for first-time users)
 MEMORY_COUNT=$(python3 -c "
 import sqlite3
-from pathlib import Path
-db_path = Path.home() / '.claude-memory' / 'memory.db'
+db_path = '${INSTALL_DIR}/memory.db'
 conn = sqlite3.connect(db_path)
 cursor = conn.cursor()
 cursor.execute('SELECT COUNT(*) FROM memories')
@@ -428,8 +430,7 @@ echo "○ Learning patterns..."
 if python3 "${INSTALL_DIR}/pattern_learner.py" update > /dev/null 2>&1; then
     PATTERN_COUNT=$(python3 -c "
 import sqlite3
-from pathlib import Path
-db_path = Path.home() / '.claude-memory' / 'memory.db'
+db_path = '${INSTALL_DIR}/memory.db'
 conn = sqlite3.connect(db_path)
 cursor = conn.cursor()
 cursor.execute('SELECT COUNT(*) FROM identity_patterns')
@@ -486,8 +487,8 @@ else
 fi
 
 # Check if PATH already configured
-PATH_EXPORT="export PATH=\"\${HOME}/.claude-memory/bin:\${PATH}\""
-if grep -q ".claude-memory/bin" "${SHELL_CONFIG}" 2>/dev/null; then
+PATH_EXPORT="export PATH=\"${INSTALL_DIR}/bin:\${PATH}\""
+if grep -Fq -- "${INSTALL_DIR}/bin" "${SHELL_CONFIG}" 2>/dev/null; then
     echo "○ PATH already configured in ${SHELL_CONFIG}"
 else
     # Add PATH export to shell config
@@ -498,7 +499,7 @@ else
 fi
 
 # Add to current session PATH
-export PATH="${HOME}/.claude-memory/bin:${PATH}"
+export PATH="${INSTALL_DIR}/bin:${PATH}"
 echo "✓ Commands available in current session"
 
 # ============================================================================
@@ -932,7 +933,7 @@ case "$INSTALL_CHOICE" in
         echo "  pip3 install -r ${REPO_DIR}/requirements-search.txt"
         echo ""
         echo "Start Web Dashboard:"
-        echo "  python3 ~/.claude-memory/ui_server.py"
+        echo "  python3 ${INSTALL_DIR}/ui_server.py"
         echo "  Then open: http://localhost:8000"
         ;;
 esac

package/scripts/postinstall.js

@@ -42,8 +42,8 @@ console.log('🌍 Global installation detected. Running system setup...\n');
 // Find the package root (where install.sh/install.ps1 lives)
 const packageRoot = path.join(__dirname, '..');
 const installScript = os.platform() === 'win32'
-    ? path.join(packageRoot, 'install.ps1')
-    : path.join(packageRoot, 'install.sh');
+    ? path.join(packageRoot, 'scripts', 'install.ps1')
+    : path.join(packageRoot, 'scripts', 'install.sh');
 
 // Check if install script exists
 if (!fs.existsSync(installScript)) {

package/scripts/start-dashboard.ps1

@@ -0,0 +1,52 @@
+# ============================================================================
+# SuperLocalMemory - Dashboard Startup Script (PowerShell)
+# Starts the web dashboard on http://localhost:8765
+# Copyright (c) 2026 Varun Pratap Bhardwaj
+# ============================================================================
+
+$ErrorActionPreference = "Stop"
+
+$SCRIPT_DIR = Split-Path -Parent $MyInvocation.MyCommand.Path
+Set-Location $SCRIPT_DIR
+
+Write-Host "=================================================================="
+Write-Host "  SuperLocalMemory - Dashboard                            "
+Write-Host "  by Varun Pratap Bhardwaj                                       "
+Write-Host "=================================================================="
+Write-Host ""
+
+# Check if Python is available
+try {
+    $pythonVersion = & python --version 2>&1
+    Write-Host "Python: $pythonVersion"
+} catch {
+    Write-Host "ERROR: Python not found in PATH" -ForegroundColor Red
+    Write-Host "Install Python 3.8+ from https://www.python.org/downloads/" -ForegroundColor Yellow
+    exit 1
+}
+
+# Check if FastAPI is installed
+try {
+    & python -c "import fastapi" 2>$null
+} catch {
+    Write-Host "WARNING: FastAPI not installed (optional dependency)" -ForegroundColor Yellow
+    Write-Host ""
+    Write-Host "To use the dashboard, install web dependencies:"
+    Write-Host "  pip install -r requirements-ui.txt"
+    Write-Host ""
+    Write-Host "Or install all features:"
+    Write-Host "  pip install -r requirements-full.txt"
+    Write-Host ""
+    exit 1
+}
+
+Write-Host "Starting dashboard server..." -ForegroundColor Green
+Write-Host ""
+Write-Host "   Dashboard: http://localhost:8765"
+Write-Host "   API Docs:  http://localhost:8765/docs"
+Write-Host ""
+Write-Host "Press Ctrl+C to stop"
+Write-Host ""
+
+# Start server
+& python ui_server.py

package/scripts/start-dashboard.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# ============================================================================
+# SuperLocalMemory - Dashboard Startup Script
+# Starts the web dashboard on http://localhost:8765
+# Copyright (c) 2026 Varun Pratap Bhardwaj
+# ============================================================================
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$SCRIPT_DIR"
+
+echo "╔══════════════════════════════════════════════════════════════╗"
+echo "║  SuperLocalMemory - Dashboard                         ║"
+echo "║  by Varun Pratap Bhardwaj                                    ║"
+echo "╚══════════════════════════════════════════════════════════════╝"
+echo ""
+
+# Check if FastAPI is installed
+if ! python3 -c "import fastapi" 2>/dev/null; then
+    echo "⚠️  FastAPI not installed (optional dependency)"
+    echo ""
+    echo "To use the dashboard, install web dependencies:"
+    echo "  pip3 install -r requirements-ui.txt"
+    echo ""
+    echo "Or install all features:"
+    echo "  pip3 install -r requirements-full.txt"
+    echo ""
+    exit 1
+fi
+
+echo "🚀 Starting dashboard server..."
+echo ""
+echo "   Dashboard: http://localhost:8765"
+echo "   API Docs:  http://localhost:8765/docs"
+echo ""
+echo "Press Ctrl+C to stop"
+echo ""
+
+# Start server
+python3 ui_server.py