Skip to content
devneeraj15Public

About

⚡ Universal Cross-Platform Hardware Telemetry, RAM Optimizer & AI Readiness Engine (Windows, macOS, Linux)

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

Repository files navigation

OptiPulse Logo

OptiPulse ⚡

Universal Hardware Telemetry, RAM Optimizer & AI Readiness Engine

The high-performance workstation diagnostic tool for Windows, macOS & Linux.

License: MIT Python 3.8+ Platform: Win | Mac | Linux UI: Dark Glassmorphism Status: Production Ready

Quick Start • Features • Advisor Engine • Use Cases • Architecture • Contributing


🌟 What is OptiPulse?

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:

  1. Live Optimization Score (0–100): Evaluates your machine against developer workstation best practices.
  2. 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.
  3. Hardware Bottleneck Detection: Automatically identifies single-channel memory bottlenecks, disk paging thrash, power governor throttles, and GPU driver mismatches.
  4. AI & Dev Stack Readiness: Checks PyTorch CUDA 12.x / Apple Silicon Metal (MPS) acceleration, local Ollama LLM daemons, and Docker environments.

🖥️ User Interface

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                                        |
+-------------------------------------------------------------------------------------------------+

🚀 Quick Start

OptiPulse runs immediately using Python 3.8+ or direct platform launch scripts.

🪟 Windows Installation & Usage

Method 1: 1-Click Launchers (Zero Terminal)

  1. Clone or download this repository.
  2. Double-click scripts/windows/run.bat to launch the native dashboard.
  3. Use scripts/windows/clean_ram.bat for 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-ram

🍎 macOS Installation & Usage

OptiPulse natively supports Apple Silicon (M1/M2/M3/M4) and Intel Macs with Metal Performance Shaders (MPS) detection:

Method 1: 1-Click Finder Runner

  1. 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 optipulse

🐧 Linux Installation & Usage (Ubuntu, Debian, Fedora, Arch)

git 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

💡 Core Features

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.

🎯 Actionable Optimization Advisor

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.

💼 Developer Use Cases

1. 🤖 AI & Machine Learning Engineers

  • Problem: You run import torch and 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.

2. 💻 Full-Stack & Systems Developers

  • 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 RAM immediately flushes several gigabytes of inactive background memory pages without terminating active tasks.

3. 🧪 Workstation Benchmarking & Hardware Validation

  • 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.

🏗️ Cross-Platform Architecture

                       +---------------------------------------+
                       |          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  |
    +-----------------------------+

📦 Python Package Installation

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-ram

🤝 Contributing

Contributions are welcome! Please check out CONTRIBUTING.md for details on code style, architectural guidelines, and pull request workflows.


📄 License

OptiPulse is open-source software licensed under the MIT License. Feel free to use, modify, and distribute it for personal, academic, or commercial workstations.

About

⚡ Universal Cross-Platform Hardware Telemetry, RAM Optimizer & AI Readiness Engine (Windows, macOS, Linux)

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages