The high-performance workstation diagnostic tool for Windows, macOS & Linux.
Quick Start • Features • Advisor Engine • Use Cases • Architecture • Contributing
OptiPulse is an open-source, zero-external-dependency workstation auditing and memory optimization engine. It audits your physical silicon, memory bandwidth, thermal governors, and AI tooling stack, providing:
- Live Optimization Score (0–100): Evaluates your machine against developer workstation best practices.
- 1-Click Universal RAM Flush: Safely releases gigabytes of inactive application working sets and standby caches across Windows, macOS, and Linux without closing your workspace.
- Hardware Bottleneck Detection: Automatically identifies single-channel memory bottlenecks, disk paging thrash, power governor throttles, and GPU driver mismatches.
- AI & Dev Stack Readiness: Checks PyTorch CUDA 12.x / Apple Silicon Metal (MPS) acceleration, local Ollama LLM daemons, and Docker environments.
OptiPulse ships with an ultra-responsive, dark-mode glassmorphism dashboard running locally with zero bloat:
+-------------------------------------------------------------------------------------------------+
| ⚡ OptiPulse [ macOS 14 Sonoma (ARM64) ] ● LIVE [ Purge RAM ]|
+-------------------------------------------------------------------------------------------------+
| |
| ( 95 ) WORKSTATION PERFORMANCE STATUS |
| / 100 All subsystems operating at peak throughput. |
| 0 swap thrashing, unified memory bus engaged, Apple Metal 3 active. |
| |
+---------------------+---------------------+---------------------+-------------------------------+
| 🧠 RAM & BANDWIDTH | ⚡ CPU & GOVERNOR | 🎮 GPU ACCEL | 🔋 BATTERY & HEALTH |
| 16.0 GB (8.2 GB) | Apple M2 Max | Metal 3 UMA | 85% (Battery Discharging) |
| Unified Memory UMA | Dynamic QoS (12C) | Dynamic VRAM | 142 Cycles | 96.0% Capacity |
| 0 pages/sec swap | Minimal Thrash | Nominal Thermals | Condition: Normal (Healthy) |
+---------------------+---------------------+---------------------+-------------------------------+
| 💾 STORAGE & HEALTH | 🤖 AI STACK |
| 465.0 GB (210 GB) | PyTorch 2.6.0 (Apple Metal MPS Active) |
| APFS Primary SSD | Ollama Daemon Active | Docker Engine Ready |
+---------------------+---------------------------------------------------------------------------+
| |
| 🎯 ACTIONABLE OPTIMIZATION PLAYBOOK |
| [OPTIMAL] High-Bandwidth Bus: Apple Unified Memory Architecture (UMA) |
| [OPTIMAL] Battery Health Optimal (96.0% Capacity, 142 Cycles) |
| [OPTIMAL] Apple Metal Performance Shaders (MPS) Active |
| [OPTIMAL] NVMe Storage Headroom & SMART Health Optimal |
+-------------------------------------------------------------------------------------------------+
OptiPulse runs immediately using Python 3.8+ or direct platform launch scripts.
Method 1: 1-Click Launchers (Zero Terminal)
- Clone or download this repository.
- Double-click
scripts/windows/run.batto launch the native dashboard. - Use
scripts/windows/clean_ram.batfor an instant 1-click desktop RAM flush.
Method 2: Command Line
# Clone the repository
git clone https://github.com/<your-username>/OptiPulse.git
cd OptiPulse
# Optional: Install psutil for enhanced sensor precision
pip install -r requirements.txt
# Run Web UI Dashboard
python -m optipulse
# Run Terminal CLI Report
python -m optipulse --cli
# Instant RAM Flush only
python -m optipulse --clean-ramOptiPulse natively supports Apple Silicon (M1/M2/M3/M4) and Intel Macs with Metal Performance Shaders (MPS) detection:
Method 1: 1-Click Finder Runner
- Double-click
scripts/macos/run.command.
Method 2: Terminal
git clone https://github.com/<your-username>/OptiPulse.git
cd OptiPulse
# Make scripts executable
chmod +x scripts/macos/*.sh scripts/macos/*.command
# Launch
python3 -m optipulsegit clone https://github.com/<your-username>/OptiPulse.git
cd OptiPulse
chmod +x scripts/linux/*.sh
# Run Web Dashboard
./scripts/linux/run.sh
# Or run headlessly over SSH
python3 -m optipulse --cli| Feature | Windows | macOS | Linux | What It Does |
|---|---|---|---|---|
| Instant RAM Purge | ✅ Win32 API | ✅ purge |
✅ Buffer Sync | Trims unreferenced memory pages and frees standby cache without closing apps. |
| Dual-Channel Audit | ✅ CIM/WMI | ✅ UMA Bus | ✅ DMI decode | Verifies whether your system is running in 64-bit single channel or 128-bit dual channel. |
| Paging & Swap Monitor | ✅ Perf Counters | ✅ vm_stat |
✅ /proc/meminfo |
Detects active disk thrashing before your start menu or terminal begins to lag. |
| Battery & Cycles | ✅ XML Report | ✅ AppleSmartBattery | ✅ sysfs BAT | Audits recharge cycle counts, maximum health retention %, and thermal/voltage throttling. |
| GPU & Acceleration | ✅ NVIDIA/Intel | ✅ Metal 3 UMA | ✅ ROCm/NVIDIA | Tracks temperatures, VRAM free space, and CUDA/MPS backend readiness. |
| AI Stack Readiness | ✅ CUDA 12.x | ✅ PyTorch MPS | ✅ ROCm/CUDA | Verifies PyTorch hardware acceleration, local Ollama models, and Docker daemons. |
| 0-100 Scoring Engine | ✅ Dynamic | ✅ Dynamic | ✅ Dynamic | Deducts points for configuration flaws and provides exact copy-paste remediation commands. |
OptiPulse does not just report numbers; it acts as a senior system engineer analyzing your machine:
- Memory Bandwidth Bottlenecks: Detects single-channel RAM configurations that cut memory bandwidth by 50% and compilation throughput by up to 25%.
- Disk Thrashing & Swap Latency: Detects when pages/sec exceed safe limits and prompts you to flush working sets.
- Power Governor Throttling: Flags systems stuck on "Power Saver" or low-frequency scaling while connected to wall power.
- PyTorch CPU-Only Warning: Instantly alerts AI practitioners if PyTorch was mistakenly installed without CUDA or MPS acceleration.
- NVMe SLC Cache Protection: Warns when primary disk storage exceeds 85%, which cripples SSD burst write performance.
- Problem: You run
import torchand train a model, only to realize hours later that PyTorch was silently running on the CPU because the wrong wheel was installed. - OptiPulse Solution: Tests PyTorch compute capability, CUDA driver version, and free VRAM in real-time.
- Problem: Heavy IDEs (VS Code, JetBrains), 30+ Chrome tabs, and local Docker containers fill memory, forcing the OS to swap to disk and causing Start Menu and typing latency.
- OptiPulse Solution: One click on
Purge Inactive RAMimmediately flushes several gigabytes of inactive background memory pages without terminating active tasks.
- Problem: You just bought or upgraded a RAM stick, GPU, or SSD and need to confirm it is running at the advertised frequency and dual-channel symmetric mode.
- OptiPulse Solution: Immediate verification of clock frequencies (e.g. 3200 MHz), channel widths, and PCIe link health.
+---------------------------------------+
| OptiPulse Front-End |
| (Dark Glassmorphism Dashboard / CLI) |
+---------------------------------------+
|
REST API / Telemetry
v
+---------------------------------------+
| OptiPulse Local Server |
| (Zero-Dependency Python) |
+---------------------------------------+
| |
+--------------+ +---------------+
v v
+-----------------------------+ +-----------------------------+
| optipulse.core.audit | | optipulse.core.cleaner |
| - Hardware Sensor Polling | | - Win32 EmptyWorkingSet |
| - Dual-Channel RAM Analysis | | - macOS Cache Purge |
| - GPU CUDA/MPS Telemetry | | - Linux Dirty Buffer Sync |
+-----------------------------+ +-----------------------------+
|
v
+-----------------------------+
| optipulse.core.advisor |
| - 0-100 Score Calculation |
| - Technical Remediation |
| - Developer Impact Mapping |
+-----------------------------+
OptiPulse can also be installed as a standard Python command-line utility:
# Install in editable mode
pip install -e .
# Launch anywhere
optipulse
# Run headless audit
optipulse --cli
# Instant RAM purge
optipulse --clean-ramContributions are welcome! Please check out CONTRIBUTING.md for details on code style, architectural guidelines, and pull request workflows.
OptiPulse is open-source software licensed under the MIT License. Feel free to use, modify, and distribute it for personal, academic, or commercial workstations.