finalizing release

solusops · solusops · commit 0f86ec50d70d · 2025-12-07T20:18:46.000+05:30
diff --git a/README.md b/README.md
@@ -5,19 +5,42 @@ Professional GPU monitoring and stress testing tool with real-time visualization
 ## Features
 
 - **Real-time Monitoring**: GPU utilization, memory, temperature, power, and system metrics
-- **Web Dashboard**: Interactive charts with live updates and historical data
+- **Web Dashboard**: Interactive charts with live updates and historical data (optional)
 - **GPU Stress Testing**: Particle simulation with auto-scaling backend load
 - **Performance Baselines**: Track and compare GPU performance over time
-- **Visualization**: Real-time particle physics simulation with interactive controls
+- **Visualization**: Real-time particle physics simulation with interactive controls (optional)
 - **Multiple Test Modes**: Quick, Standard, Extended, Stress Test, and Custom configurations
+- **Modular Installation**: Install only what you need (CLI-only, with Web UI, or Full)
 
 ## Requirements
 
 - Python 3.8+
-- NVIDIA GPU with drivers
-- CUDA Toolkit 12.0+ (for GPU benchmarking)
+- NVIDIA GPU with drivers (optional - for GPU benchmarking)
+- CUDA Toolkit 12.0+ (optional - for GPU acceleration)
 - Windows 10/11 or Linux
 
+## Installation Options
+
+The tool supports three installation types:
+
+### 1. MINIMAL (CLI only)
+- Command-line interface with rich output
+- Basic monitoring (click, rich, psutil)
+- Smallest installation (~10 MB)
+- **Use case**: Headless servers, minimal footprint
+
+### 2. STANDARD (CLI + Web UI)
+- Everything in Minimal
+- Web dashboard with real-time charts
+- REST API endpoints
+- **Use case**: Remote monitoring, multiple users
+
+### 3. FULL (Standard + Visualization + GPU)
+- Everything in Standard
+- Particle simulation visualization
+- GPU benchmarking support
+- **Use case**: Full-featured installation, development
+
 ## Quick Start
 
 ### Installation
@@ -32,28 +55,34 @@ Professional GPU monitoring and stress testing tool with real-time visualization
    .\setup.ps1
    ```
 
-3. **Launch** web dashboard:
+3. **Select** installation type (1=Minimal, 2=Standard, 3=Full)
+
+4. **Launch**:
 
    ```powershell
+   # For MINIMAL or STANDARD:
+   python health_monitor.py cli
+   
+   # For STANDARD or FULL:
    python health_monitor.py web
-   ```text
-   Access at: http://localhost:8090
+   ```
 
 ### Usage
 
-**Web Dashboard (Recommended)**
+**Web Dashboard** (Standard/Full installations)
 
 ```powershell
 python health_monitor.py web
 ```
+Access at: http://localhost:8090
 
-**Terminal Interface**
+**Terminal Interface** (All installations)
 
 ```powershell
 python health_monitor.py cli
 ```
 
-**Command-Line Benchmark**
+**Command-Line Benchmark** (Full installation with GPU libraries)
 
 ```powershell
 # Quick 15s test
@@ -136,10 +165,16 @@ REST API endpoints (web mode):
 - Download CUDA Toolkit: <https://developer.nvidia.com/cuda-downloads>
 - Re-run `setup.ps1` after installation
 
-**Benchmark disabled**
+**Benchmark disabled / Simulation button grayed out**
+
+- GPU compute libraries not installed or not detected
+- Solution 1: Run `python health_monitor.py refresh` to update detection cache
+- Solution 2: Re-run `setup.ps1` and install CuPy or PyTorch
+
+**CuPy installation fails on CUDA 13.0**
 
-- GPU compute libraries not installed
-- Run `setup.ps1` and install CuPy or PyTorch when prompted
+- Use: `pip install "cupy-cuda12x>=13.0.0"`
+- CuPy 13.x supports CUDA 12.x and 13.0
 
 **Port already in use**
 
diff --git a/health_monitor.py b/health_monitor.py
@@ -343,6 +343,69 @@ def term(ctx):
     """Launch the interactive terminal dashboard."""
     _run_app(ctx.obj['config_path'], port=None, nodes=None, once=False, cli_mode=True)
 
+@cli.command()
+def refresh():
+    """Refresh feature detection cache (run after installing GPU libraries)."""
+    from monitor.utils import detect_features
+    import os
+    from pathlib import Path
+    
+    cache_file = Path('.features_cache')
+    if cache_file.exists():
+        os.remove(cache_file)
+        console.print("[yellow]Removed old cache[/yellow]")
+    
+    # Run diagnostics first
+    console.print("\n[cyan]Running diagnostics...[/cyan]")
+    
+    # Test CuPy
+    try:
+        import cupy as cp
+        cp.cuda.Device(0).compute_capability
+        console.print("  CuPy: [green]OK[/green]")
+    except ImportError:
+        console.print("  CuPy: [yellow]Not installed[/yellow]")
+    except Exception as e:
+        console.print(f"  CuPy: [red]Error - {str(e)}[/red]")
+    
+    # Test PyTorch
+    try:
+        import torch
+        if torch.cuda.is_available():
+            console.print(f"  PyTorch: [green]OK (CUDA {torch.version.cuda})[/green]")
+        else:
+            console.print(f"  PyTorch: [red]Installed but CUDA not available[/red]")
+            console.print(f"           [dim]PyTorch version: {torch.__version__}[/dim]")
+    except ImportError:
+        console.print("  PyTorch: [yellow]Not installed[/yellow]")
+    except Exception as e:
+        console.print(f"  PyTorch: [red]Error - {str(e)}[/red]")
+    
+    console.print("\n[cyan]Detecting features...[/cyan]")
+    features = detect_features(force=True)
+    
+    console.print("\n[green]Feature Detection Results:[/green]")
+    console.print(f"  NVIDIA GPU: {'[green]Available[/green]' if features.get('nvidia_smi') else '[red]Not found[/red]'}")
+    console.print(f"  CuPy: {'[green]Available[/green]' if features.get('cupy') else '[yellow]Not installed[/yellow]'}")
+    console.print(f"  PyTorch: {'[green]Available[/green]' if features.get('torch') else '[yellow]Not installed[/yellow]'}")
+    console.print(f"  GPU Benchmark: {'[green]Enabled[/green]' if features.get('gpu_benchmark') else '[red]Disabled[/red]'}")
+    
+    if not features.get('gpu_benchmark'):
+        console.print("\n[yellow]GPU Benchmark is DISABLED because:[/yellow]")
+        if not features.get('cupy') and not features.get('torch'):
+            console.print("  [red]Neither CuPy nor PyTorch with CUDA is available[/red]")
+        console.print("\n[cyan]To fix:[/cyan]")
+        console.print("  1. Install a GPU library:")
+        console.print("     pip install \"cupy-cuda12x>=13.0.0\"")
+        console.print("     OR")
+        console.print("     pip install torch --index-url https://download.pytorch.org/whl/cu121")
+        console.print("  2. Run 'python health_monitor.py refresh' again")
+    else:
+        console.print("\n[green]All GPU features enabled![/green]")
+    
+    console.print("\n[cyan]Cache updated successfully![/cyan]\n")
+
+
 
 if __name__ == '__main__':
     cli.add_command(benchmark_cli)
diff --git a/monitor/api/static/benchmark.js b/monitor/api/static/benchmark.js
@@ -30,16 +30,21 @@ function selectMode(mode) {
     document.getElementById('custom-controls').style.display = mode === 'custom' ? 'block' : 'none';
     
     // Disable Start Simulation button for stress-test and custom modes
+    // (or if GPU features not available - checked by loadFeatures)
     const simBtn = document.getElementById('start-sim-btn');
     if (simBtn) {
         if (mode === 'stress-test' || mode === 'custom') {
             simBtn.disabled = true;
             simBtn.style.opacity = '0.5';
             simBtn.style.cursor = 'not-allowed';
         } else {
-            simBtn.disabled = false;
-            simBtn.style.opacity = '1';
-            simBtn.style.cursor = 'pointer';
+            // Only enable if not already disabled by loadFeatures
+            // Check if it's disabled due to missing GPU libraries
+            if (simBtn.title !== 'Install CuPy or PyTorch for simulation') {
+                simBtn.disabled = false;
+                simBtn.style.opacity = '1';
+                simBtn.style.cursor = 'pointer';
+            }
         }
     }
     
@@ -182,7 +187,7 @@ async function pollBenchmarkStatus() {
 
 function displayBenchmarkResults(results) {
     const resultsDiv = document.getElementById('benchmark-results');
-    resultsDiv.innerHTML = '<h3>📊 Benchmark Results</h3>';
+    resultsDiv.innerHTML = '<h3>Benchmark Results</h3>';
     
     // Build results HTML based on benchmark type
     let html = '<div class="results-grid">';
diff --git a/monitor/api/static/main.js b/monitor/api/static/main.js
@@ -770,23 +770,23 @@ async function checkForUpdates() {
                 const result = await install.json();
                 
                 if (result.status === 'success') {
-                    btn.textContent = '✓ Restart App';
+                    btn.textContent = 'Restart App';
                     btn.classList.add('success');
                     btn.setAttribute('data-tooltip', 'Update installed - restart application');
                 } else {
-                    btn.textContent = '✗ Update Failed';
+                    btn.textContent = 'Update Failed';
                     btn.classList.add('error');
                     btn.setAttribute('data-tooltip', result.message);
                     btn.disabled = false;
                 }
             };
         } else if (data.error) {
-            btn.textContent = '✗ Check Failed';
+            btn.textContent = 'Check Failed';
             btn.classList.add('error');
             btn.setAttribute('data-tooltip', data.error);
             btn.disabled = false;
         } else {
-            btn.textContent = '✓ Latest Version';
+            btn.textContent = 'Latest Version';
             btn.classList.add('success');
             btn.setAttribute('data-tooltip', `Version ${data.current}`);
             setTimeout(() => {
@@ -797,7 +797,7 @@ async function checkForUpdates() {
             }, 3000);
         }
     } catch (error) {
-        btn.textContent = '✗ Network Error';
+        btn.textContent = 'Network Error';
         btn.classList.add('error');
         btn.setAttribute('data-tooltip', 'Could not connect to update server');
         btn.disabled = false;
@@ -832,13 +832,14 @@ async function loadFeatures() {
         const response = await fetch('/api/features');
         const features = await response.json();
         
+        const benchTab = document.querySelector('[data-tab="benchmark"]');
+        const startBtn = document.getElementById('start-bench-btn');
+        const startSimBtn = document.getElementById('start-sim-btn');
+        const typeButtons = document.querySelectorAll('.type-btn');
+        const modeButtons = document.querySelectorAll('.mode-btn');
+        
         // Disable benchmark controls if GPU benchmark not available
         if (!features.gpu_benchmark) {
-            const benchTab = document.querySelector('[data-tab="benchmark"]');
-            const startBtn = document.getElementById('start-bench-btn');
-            const typeButtons = document.querySelectorAll('.type-btn');
-            const modeButtons = document.querySelectorAll('.mode-btn');
-            
             if (benchTab) {
                 benchTab.classList.add('disabled');
                 benchTab.setAttribute('data-tooltip', 'Install CuPy or PyTorch for GPU benchmarking');
@@ -852,6 +853,13 @@ async function loadFeatures() {
                 startBtn.title = 'GPU benchmark libraries not installed';
             }
             
+            if (startSimBtn) {
+                startSimBtn.disabled = true;
+                startSimBtn.style.opacity = '0.5';
+                startSimBtn.style.cursor = 'not-allowed';
+                startSimBtn.title = 'Install CuPy or PyTorch for simulation';
+            }
+            
             typeButtons.forEach(btn => {
                 btn.disabled = true;
                 btn.style.opacity = '0.5';
@@ -863,6 +871,39 @@ async function loadFeatures() {
                 btn.style.opacity = '0.5';
                 btn.style.cursor = 'not-allowed';
             });
+        } else {
+            // ENABLE controls when GPU benchmark IS available
+            if (benchTab) {
+                benchTab.classList.remove('disabled');
+                benchTab.removeAttribute('data-tooltip');
+                benchTab.style.pointerEvents = '';
+            }
+            
+            if (startBtn) {
+                startBtn.disabled = false;
+                startBtn.style.opacity = '1';
+                startBtn.style.cursor = 'pointer';
+                startBtn.title = 'Start GPU benchmark';
+            }
+            
+            if (startSimBtn) {
+                startSimBtn.disabled = false;
+                startSimBtn.style.opacity = '1';
+                startSimBtn.style.cursor = 'pointer';
+                startSimBtn.title = 'Start particle simulation with visualization';
+            }
+            
+            typeButtons.forEach(btn => {
+                btn.disabled = false;
+                btn.style.opacity = '1';
+                btn.style.cursor = 'pointer';
+            });
+            
+            modeButtons.forEach(btn => {
+                btn.disabled = false;
+                btn.style.opacity = '1';
+                btn.style.cursor = 'pointer';
+            });
         }
     } catch (error) {
         console.error('Error loading features:', error);
diff --git a/monitor/api/templates/simulation.html b/monitor/api/templates/simulation.html
@@ -255,20 +255,20 @@ <h1>🎱 3D Ball Physics Simulation</h1>
             <div id="controls">
                 <!-- Baseline Information -->
                 <div class="control-group" id="sim-baseline-info" style="display: none;">
-                    <h3>📊 Baseline (Simulation Mode)</h3>
+                    <h3>Baseline (Simulation Mode)</h3>
                     <div id="sim-baseline-details" style="font-size: 0.9em; line-height: 1.6;">
                         <!-- Baseline content loaded via JavaScript -->
                     </div>
                 </div>
                 
                 <div class="control-group">
-                    <h3>⚡ Simulation Control</h3>
+                    <h3>Simulation Control</h3>
                     <button id="startBtn" class="button">Start Simulation</button>
                     <button id="stopBtn" class="button stop" style="display: none;">Stop Simulation</button>
                 </div>
                 
                 <div class="control-group">
-                    <h3>🎮 Physics Parameters</h3>
+                    <h3>Physics Parameters</h3>
                     
                     <div class="slider-control">
                         <label>Gravity: <span class="slider-value" id="gravityValue">500</span></label>
diff --git a/requirements.txt b/requirements.txt
@@ -1,19 +1,28 @@
-# Core dependencies
-fastapi>=0.104.0
-uvicorn[standard]>=0.24.0
-websockets>=12.0
-psutil>=5.9.0
-pyyaml>=6.0
+# MINIMAL CORE - CLI only (no web UI)
 click>=8.1.0
 rich>=13.0.0
-numpy>=1.24.0
+psutil>=5.9.0
+pyyaml>=6.0
 requests>=2.31.0
-pygame>=2.5.0
 
-# GPU libraries (optional - choose one based on CUDA version)
+# WEB UI (optional - for web dashboard)
+# Uncomment these lines to enable web interface:
+# fastapi>=0.104.0
+# uvicorn[standard]>=0.24.0
+# websockets>=12.0
+
+# VISUALIZATION (optional - for particle simulation)
+# Uncomment these lines to enable visualization:
+# pygame>=2.5.0
+# numpy>=1.24.0
+
+# GPU ACCELERATION (optional - for benchmarking)
+# Choose one based on your CUDA version:
+#
 # CuPy for CUDA 12.x (recommended):
-#   pip install cupy-cuda12x>=12.0.0
+#   pip install cupy-cuda12x>=13.0.0
 #
 # PyTorch with CUDA 12.1:
 #   pip install torch --index-url https://download.pytorch.org/whl/cu121
 
+
