DEV Community

Cover image for SysAmp v2.91 DevOps Monitor
devkshitij7
devkshitij7

Posted on

SysAmp v2.91 DevOps Monitor

#devchallenge #hf26challenge #ai #gemma

Hacktoberfest Open-Source AI Challenge: Ghost in the Machine Submission 👻🌼

**This is a submission for the Hacktoberfest Open-Source AI Challenge Week 4: Ghost in the Machine

What I Built

SysAmp v2.91 is a full-stack system observability deck and Docker container orchestrator resurrected in the spirit of the iconic 1997 Winamp 2.x interface, infused with local open-weight AI.

The Interpretation of the Theme: Ghost in the Machine

For this challenge, we asked ourselves: What if the ghosts haunting our machines aren't spooky apparitions, but the beloved software spirits of the early internet?

In 1997, Winamp was on every developer's screen. Today, developers stare at sterile, cold cloud metric dashboards and heavy Electron containers. SysAmp brings the ghost of Winamp back to life — not as a retro skin, but as a living, breathing telemetry cockpit. Every pixelated EQ band now channels live CPU core voltages and RAM pressure, and the legendary "Whip the Llama" slogan is reborn through an on-device Google Gemma AI doctor that diagnoses dead and crashed Docker containers.

Demo

  • Live Agent Session: View Curated DevRelay Agent Session on DEV
  • Local Walkthrough:
    1. Dual-Mode Visualizer: Real-time 18-bar segmented LED Spectrum Analyzer (Green $\rightarrow$ Yellow $\rightarrow$ Red) and an Oscilloscope waveform driven by actual hardware clock speed.
    2. 10-Band Hardware Equalizer: Sliders dynamically driven by CPU Cores 1–4, RAM, Swap, Disk I/O, and Network Rx/Tx throughput.
    3. Playlist Editor as Container Manager: Play (Start), Pause (Freeze), and Stop containers with authentic retro beeps via the Web Audio API.
    4. Windowshade Mini-Mode: Double-click the title bar to collapse into a sleek 14px horizontal status strip for non-intrusive desktop monitoring.
    5. ⚡ "Whip the Llama" AI Doctor: One-click instant diagnostic query sending crashed container logs to local Gemma, which streams 1-sentence fixes across the green LED marquee.
    6. Playlist Exporter: Exports running containers as a production-ready docker-compose.yml (#EXTM3U header format).

Code

The complete source code is open source and available on GitHub:

https://short.do/OmV0jC

Architecture Overview:

  • Frontend: React 19, Vite, Tailwind CSS v4, Lucide Icons, HTML5 Canvas, Web Audio API synthesizer.
  • Backend Bridge: Node.js, Express (Port 4091), systeminformation for safe cross-platform hardware telemetry, dockerode for Docker socket communication.
  • Smart Fallback Engine: If the Docker daemon is offline, SysAmp smoothly falls back to live host OS process tracking (pid-*) without crashing.
  • Local Inference: Native HTTP client interfacing with Ollama's local REST endpoint (localhost:11434) running gemma3:4b.

How I Built It

1. Open-Weight AI Core: Google Gemma (gemma3:4b)

At the heart of SysAmp's AI Doctor is Google's open-weight Gemma model (gemma3:4b quantized at Q4_K_M), running locally via Ollama.

When an engineer clicks the lightning bolt (⚡) or when a container crashes:

  1. SysAmp extracts stderr/stdout logs and container metadata (exit codes, memory caps, port conflicts).
  2. It prompts local Gemma to act as a Unix systems engineer: 
   You are SysAmp AI Doctor. Analyze this Docker container and give a 1-sentence root cause and exact CLI fix command.
   Container: worker-queue-service (node:20-alpine)
   Status: EXITED
   Recent Logs: FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory
Enter fullscreen mode Exit fullscreen mode
  1. Gemma identifies the root cause (e.g., Exit Code 137 OOMKilled) and provides an immediate remediation command (docker update --memory 512m ...).
  2. The response streams live across the vintage green LED marquee screen and into the diagnostic drawer.

2. Dual-Engine Telemetry Bridge

Built with Node.js and systeminformation, the backend maps real hardware load onto Winamp's 10-band equalizer sliders:

  • Bands 1–4: Core loads for CPU 0 through CPU 3
  • Band 5: Physical RAM utilization %
  • Band 6: Swap usage %
  • Band 7: Disk transfer pressure
  • Bands 8–9: Active network I/O (Rx/Tx KB/s)
  • Band 10: Total CPU percentage

Why Does Open Innovation Matter?

Why does open innovation matter for a system monitoring deck?

  1. Production Infrastructure Privacy: System logs, crash dumps, and internal Docker configurations contain sensitive tokens, internal IPs, and proprietary source snippets. Streaming these to a proprietary third-party cloud API introduces massive compliance and security risks. By running Gemma locally, zero telemetry ever leaves the machine.
  2. Air-Gapped & Offline Resilience: When your network interface drops or an outage hits your internet connection, a cloud-dependent AI assistant is dead in the water. An open-weight model running on localhost operates with 100% fidelity even when the network cable is unplugged.
  3. Zero Marginal Cost: Observability software shouldn't incur per-token SaaS subscription billing just to watch a service loop or inspect a container log. Open-weight models empower individual hackers and home-lab enthusiasts to have world-class AI diagnosis without a credit card.

My Agent Session

This project was reviewed, tested, and audited live using Antigravity and recorded to DevRelay:

SysAmp v2.91 — Retro Winamp Observability Deck & Docker Manager with Gemma AI Doctor
You

We have to conduct a live agent review session for SysAmp v2.91 in Antigravity and record it so we can submit it to DevRelay.

Agent

Starting the live agent review for SysAmp v2.91. Let's inspect the repository layout, dependencies, and architectural design across frontend, backend, and the local AI integration.

You

Inspect the backend architecture, Docker container bridge, and hardware telemetry engine.

Agent

Inspected backend/server.js and package.json:
- Framework: Node.js Express server on port 4091 with CORS support.
- Telemetry: Uses systeminformation to gather CPU per-core loads, RAM, Swap, disk I/O, and network transfer rates (rx/tx KB/s).
- 10-Band Equalizer: Maps 10 hardware channels [CPU1-4, RAM, SWAP, DISK, NET-IN, NET-OUT, TOTAL-CPU] to Winamp EQ sliders.
- Dual-Engine Fallback: Queries Docker daemon via dockerode; if Docker is offline, falls back seamlessly to top OS host processes (PIDs) with memory RSS and CPU tracking.
- Verified live telemetry output on host system: CPU 95.6% load, 4 active cores, 57% RAM used, active network interface detected.

You

Audit the frontend implementation, UI modules, canvas spectrum visualizer, and the 'Whip the Llama' AI diagnostic engine.

Agent

Audited frontend/src/App.jsx, README.md, and package.json:
- Architecture: React 19 + Vite + Tailwind CSS v4 + Lucide icons.
- Retro UI: Faithful 1997 Winamp 2.x recreation with Main Player, 10-Band Equalizer, Playlist Editor, and Windowshade mode.
- 3 Theming Modes: Classic 1997, Cyber Matrix, and Amber CRT with authentic pixel styling.
- Canvas Visualizer: Dual-mode HTML5 Canvas engine rendering an 18-bar segmented LED Spectrum Analyzer (Green -> Yellow -> Red) and an Oscilloscope waveform modulated by live CPU load.
- 'Whip the Llama' AI Doctor: Queries local Ollama at localhost:11434 (gemma3:4b) with container logs to extract instant root causes (e.g. OOMKilled exit code 137) and remediation commands, streaming results across the green LED marquee.
- Playlist Exporter: Generates production-ready docker-compose.yml files from running container tracks.
- Verified production build: Vite compiled successfully with zero errors (dist/assets/index.js 176 kB, dist/assets/index.css 22.5 kB).

You

Review complete. Please summarize the audit and submit the session to DevRelay.

Agent

Compiled the full live review audit report and verified all systems for SysAmp v2.91. Session recorded and submitted to DevRelay.

8 of 8 messages

(Direct link: DevRelay Agent Session #1254)

The Spirit of It

There was something unforgettable about 1997. Software was tactile, responsive, idiosyncratic, and fun. It had pixel fonts, beveled chrome buttons, and green phosphor readouts. When Winamp launched with "Winamp, it really whips the llama's ass!", it captured the rebel spirit of early open computing.

Building SysAmp v2.91 was like holding a digital séance: summoning the spirit of Nullsoft Winamp into the era of containerized microservices and on-device generative AI. When you click play and hear the 8-bit square wave beep while your CPU core stats dance across the spectrum analyzer, software feels magical again.

Prize Categories

  • Best Use of Gemma (Featured Category): Powered by local open-weight Google Gemma (gemma3:4b) via Ollama for container root-cause log diagnostics and automated CLI recovery commands. **

Top comments (0)