PC_Workman 1.6.8

Real-time PC monitoring + AI diagnostics.

Overview

PC_Workman is a real-time system monitoring tool built in Python. It combines live performance diagnostics, AI-assisted analysis, and a modular architecture designed for intelligent system optimization.

What it does:

• Real-time CPU, GPU, RAM, and network monitoring
• Process intelligence (identifies what's consuming resources)
• AI-powered diagnostics via hck_GPT integration
• Historical trend analysis (see patterns over time)
• Gaming analytics with bottleneck detection

Why it's different:

• Traditional tools show "CPU: 87%" → PC_Workman explains why
• Time-travel diagnostics → click any historical point to see what was running
• Voltage spike detection → unique feature nobody else has
• Built for understanding, not just watching

🚀 Quick Start

Windows Users (Easiest)

1. Download PC_Workman.exe from Releases
2. Double-click
3. Done ✅

Get Latest Release

Developers

git clone https://github.com/HuckleR2003/PC_Workman_HCK.git
cd PC_Workman_HCK
pip install -r requirements.txt
python startup.py

Full setup guide: GETTING_STARTED.md

Features

Core Monitoring

• Real-time CPU, GPU, RAM tracking
• Network bandwidth per-application
• Process identification and labeling
• Temperature monitoring with trends
• Historical data logging (daily, weekly, monthly)

Intelligence (hck_GPT)

• Local insights engine — habit tracking, anomaly awareness, personalized teasers
• "Today Report" with usage chart, top processes, and alert status
• 7-day recurring pattern detection (games, browsers, dev tools)
• Spike/anomaly reporting from Stats Engine events
• Gaming analytics with FPS tracking
• Bottleneck detection (CPU vs GPU limited)
• Safe system optimization with rollback

Interface

• Modern dashboard (Apple-inspired design)
• Ultra-compact information density
• Color-coded process lists
• Interactive charts and metrics
• Click-to-investigate functionality

Coming Soon

• Official .exe installer (v1.6.0)
• Voltage spike correlation (v1.6.0)
• Real temperature sensors (v1.5.1)
• ML pattern detection (v2.0)
• Predictive maintenance alerts (v2.0)

Architecture

Modular, scalable design:

PC_Workman/
├── core/              # Real-time data collection (background-threaded monitor)
├── hck_gpt/           # Local AI insights engine (no external API)
├── hck_stats_engine/  # SQLite pipeline: minute/hourly/daily/monthly stats
├── ui/
│   ├── windows/       # Main window modes (expanded, minimal)
│   ├── components/    # Reusable widgets (charts, LED bars, tooltips)
│   └── pages/         # Full-page views (monitoring, fan control)
├── data/
│   ├── logs/          # CSV logs (raw, hourly, daily, weekly, monthly)
│   ├── cache/         # Runtime cache & process patterns
│   └── hck_stats.db   # SQLite long-term storage (WAL mode)
└── tests/             # Unit tests

Design principles:

• Dynamic component registry (auto-registration)
• Seamless inter-module communication
• Designed for future expansion
• Educational value (demonstrates Python best practices)

What's New [1.6.8] - 2026-02-17 - CURRENT

hck_GPT Intelligence System

• Local insights engine: habit tracking, anomaly awareness, personalized teasers
• "Today Report!" button — rainbow gradient, opens detailed report window
• Today Report: session/lifetime uptime, CPU/GPU/RAM chart, top processes, alert status
• 7-day recurring pattern detection with personality-driven messages
• New commands: stats, alerts, insights, teaser (+ Polish language)
• Smooth fade gradient banner, auto-greeting, periodic insight ticker

HCK Stats Engine v2 (SQLite Long-Term Storage)

• SQLite-based pipeline: minute/hourly/daily/weekly/monthly aggregation
• Process tracking: per-hour and per-day CPU/RAM breakdown per process
• WAL mode for concurrent UI reads + scheduler writes
• Automatic pruning (7d minutes, 90d hourly, forever daily+)
• Graceful degradation: SQLite failure falls back to CSV
• New modules: db_manager, aggregator, process_aggregator, query_api, events

MONITORING & ALERTS - Time-Travel Statistics Center

• Temperature area chart with 1D/3D/1W/1M scale selection
• Spike detection (mean + 1.5*std) with yellow glow highlighting
• Hover tooltips with CPU/RAM/GPU values at each time point
• Voltage/Load multi-line chart with anomaly detection
• Stats panels: Today AVG, Lifetime AVG, Max Safe, Current, Spikes count
• AI learning status badges per metric
• Events log from SQLite database

Overlay CPU/RAM/GPU

• Redefined as always-on-top Toplevel window (outside program, on desktop)
• Auto-launches on startup via root.after(1500, ...)
• Draggable, frameless, hidden from taskbar (-toolwindow)

My PC Improvements

• Hey-USER table: replaced with cropped ProInfoTable (MOTHERBOARD + CPU sections)
• Quick action buttons now navigate to actual pages (Stats & Alerts -> Monitoring, etc.)
• Stability Tests page with real diagnostics (file integrity, engine status, logs)

Sidebar Navigation Stability

• Dashboard-only updates: _update_hardware_cards and _update_top5_processes guarded by current_view == "dashboard"
• winfo_exists() guards on all widget update methods
• Fixed routing IDs for new subitems (temperature, voltage, alerts)

Performance Optimization

• Background-threaded psutil.process_iter() — GUI thread never blocks on system calls
• Dashboard update cadence: 300ms → 1000ms, hardware cards every 2s, tray every 3s
• Widget reuse pattern for TOP 5 processes (no destroy/recreate)
• Nav button gradients drawn once (removed per-pixel <Configure> redraw on window move)
• Realtime chart: reusable canvas rectangles, 2s interval

Dashboard Chart

• All time filters working: LIVE, 1H, 4H, 1D, 1W, 1M
• Pulls real data from hck_stats_engine SQLite (minute/hourly/daily tables)
• Auto-refresh historical data every ~30s

Stats Engine Fixes

• Lifetime uptime persists across sessions (shutdown flush + multi-table query)
• System idle process filtered at source (no more "1012% CPU" messages)

Codebase Cleanup

• Removed unused: utils/, settings/, expandable_list.py, dead animation code
• Removed in-app mini-monitor overlay (kept external one)
• Integrated temperature data pipeline: scheduler -> aggregator -> SQLite

---

What's New [1.6.3] - 2026-01-12

Fan Dashboard Overhaul

• Complete visual redesign with purple gradient temperature graph
• Improved data density and readability
• Enhanced visual hierarchy with gradient-based design language

Your PC Section - UI Compression

• PRO INFO TABLE optimization (~25% size reduction)
  • Removed redundant MOTHERBOARD voltage parameters (CPU, CPU SA, CPU AUX)
  • Simplified TEMPERATURE monitoring (removed GPU, MOS, PCH, TZ00 sensors)
  • Consolidated DISK SPACE and BODY FANS into vertical layout
  • Reduced padding throughout (5px → 1px, 2px → 1px)
  • Adjusted section headers (pady: 2px → 1px)
  • Model badge optimization (padx: 10px → 8px, pady: 3px → 2px)

New Menu System

• Replaced hardware cards with feature-focused navigation menu
• Five interactive menu buttons with background graphics:
  1. YOUR PC - Health Report - Component health monitoring with session history
  2. Statistics & Monitoring - Monthly statistics with spike detection
  3. Optimization Dashboard - Automated optimization for legacy hardware
  4. Daily Advanced System Cleanup - Consolidated cleanup utilities
  5. First Device Setup - Driver updates and service management
• Ultra-compact text rendering (6pt Consolas, 9px line spacing)
• Title overlays positioned at 25% image height
• Description text placed below images for improved readability

Technical Improvements

• Custom black scrollbar for PRO INFO TABLE (10px width)
• Canvas-based gradient rendering
• PIL image manipulation for button backgrounds
• Optimized frame padding across all sections
• Maintained 980x575 window size (reverted experimental enlargement)

Notes

• Menu buttons are currently placeholders - functionality to be implemented in future releases
• Focus on UI density and information hierarchy
• No breaking changes to existing features

What's New [1.6.1] - 10.01.2026

Fan Dashboard Evolution - Complete overhaul (3 iterations in one night!) - General fixes

Others

-Redesigned from scratch with high market tools research - inspired UI. -Beautiful purple gradient fan curve graph with interactive drag-and-drop points -Compact 2x2 fan status cards with real-time RPM monitoring & connection status -Streamlined profile system (Default, Silent, AI, P1, P2) -Smart profile saving to data/profiles/ with JSON export/import -Removed clutter - deleted right panel, focused on what matters -40% smaller graph height for better space utilization

✪ Main Window UX Polish

-Fixed process CPU/RAM calculations (now shows system-relative %, not per-core) Removed padding between navigation tabs for cleaner look Killed animated gradients for better performance Stripped unnecessary descriptive texts

! ✪ NEW: Floating System Monitor Widget ✪

Always-on-top overlay in top-right corner (outside main window!) Real-time CPU/RAM/GPU usage with color-coded alerts Draggable, minimizable, frameless design Runs independently - keep it visible while working Launch from Navigation menu → "Floating Monitor"

✪ Codebase Cleanup

Removed deprecated fan dashboard versions (ai, pro, ultra) Consolidated to single fan_dashboard.py - 3 files deleted, ~100KB saved Purged all pycache and .pyc files Fixed broken imports after cleanup

What's New [v1.5.7] - 23.12.2025

Modern Dashboard Redesign

• Apple-inspired flat design with gradient accents
• Ultra-compact TOP 5 process lists
• Side-by-side CPU/RAM indicators
• Color-coded visual hierarchy
• 40% more information density

Hardware Health Monitoring

• Three-column layout (CPU | RAM | GPU)
• Real hardware names (actual Intel/AMD/NVIDIA)
• Intelligent load classification (Normal → Critical)
• Temperature bars with heat-based coloring

Gaming Analytics

• Per-game performance tracking
• FPS correlation with system load
• Bottleneck detection
• Thermal signature per game

Optimization Tools

• Windows services management
• Gaming mode toggle
• Startup programs cleanup
• Safe system optimizations with rollback

📁 Project Structure

HCK_Labs/PC_Workman_HCK/
├── core/
│   ├── monitor.py           # Background-threaded system monitoring
│   ├── logger.py            # File logging system
│   ├── analyzer.py          # Data analysis & trends
│   ├── scheduler.py         # Background scheduler
│   ├── process_classifier.py # Process categorization (Gaming/Browser/Dev/etc.)
│   └── process_data_manager.py # Process tracking & statistics
├── hck_gpt/
│   ├── chat_handler.py      # Command routing (stats, alerts, insights, etc.)
│   ├── insights.py          # Local InsightsEngine (habits, anomalies, teasers)
│   ├── panel.py             # Chat panel UI (gradient banner, ticker, greeting)
│   ├── report_window.py     # Today Report Toplevel (chart, processes, alerts)
│   └── services_manager.py  # Windows services optimization
├── hck_stats_engine/
│   ├── db_manager.py        # WAL-mode SQLite, thread-local connections
│   ├── aggregator.py        # Minute/hourly/daily/monthly aggregation
│   ├── process_aggregator.py # Per-process CPU/RAM tracking
│   ├── query_api.py         # Range queries with auto-granularity
│   ├── events.py            # Spike/anomaly detection
│   └── constants.py         # Retention config (7d/90d/forever)
├── ui/
│   ├── windows/
│   │   ├── main_window_expanded.py  # Full dashboard (980x575)
│   │   └── main_window.py           # Minimal mode
│   ├── components/
│   │   ├── charts.py, led_bars.py, yourpc_page.py, ...
│   └── pages/
│       ├── monitoring_alerts.py     # Time-Travel Statistics Center
│       └── fan_control.py           # Fan curves & hardware
├── data/
│   ├── logs/                # CSV logs (raw, hourly, daily)
│   ├── cache/               # Runtime cache
│   └── hck_stats.db         # SQLite long-term storage
├── tests/
├── CHANGELOG.md
├── requirements.txt
├── startup.py
└── import_core.py

🛠️ Installation

Requirements

• Python 3.9+ (or use .exe)
• Windows 10+ (Linux/Mac support coming)
• RAM: 200MB minimum
• Disk: 300MB (if using .exe installer)

From Source

# Clone repository
git clone https://github.com/HuckleR2003/PC_Workman_HCK.git
cd PC_Workman_HCK

# Create virtual environment (recommended)
python -m venv venv
.\venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run
python startup.py

From .exe

Download from Releases → Double-click → Done

📖 Usage

First Launch

1. Dashboard opens showing real-time metrics
2. Give it 5 seconds to collect initial data
3. CPU/RAM/GPU bars populate
4. Click tabs to explore features

Main Tabs

• Dashboard - Real-time overview
• Your PC - Hardware health & component status
• Fan Control - Custom fan curves (advanced)
• Network - Per-app bandwidth usage
• Gaming - Game-specific analytics

Understanding the Data

• Green (0-30%) - Normal operation
• Yellow (30-60%) - Moderate load
• Orange (60-85%) - Heavy load
• Red (85%+) - Critical

Click any process to see more details.

📈 Data & Privacy

What's Collected

• CPU/GPU/RAM usage (on your device only)
• Process names (to identify running applications)
• Temperature readings (from hardware sensors)
• Network usage (local tracking)

Where It's Stored

• Local only: /data/logs/ directory
• No cloud: Everything stays on your PC
• No telemetry: Zero tracking or analytics
• You control it: Delete anytime

Privacy Assurance

• 100% local operation
• No data transmission
• No user tracking
• Open source (code is auditable)

🗂️ Versioning

Version	Status	Key Features
v1.0.0	Released	Basic architecture
v1.0.6	Stable	First working UI
v1.3.3	Released	hck_GPT integration
v1.4.0	Released	System tray, enhanced UI
v1.5.7	Released	Modern dashboard, hardware monitoring
v1.6.3	Released	Fan dashboard, menu system, .exe
v1.6.8	Current	Stats Engine v2, Time-Travel, Monitoring
v2.0.0	Q2 2026	ML patterns, advanced gaming

Full Changelog

🤝 Contributing

For Users

• Found a bug? Open Issue
• Have an idea? Start Discussion
• Want to help? See CONTRIBUTING.md

For Developers

• We welcome pull requests
• Follow existing code style
• Include tests for new features
• Update documentation

💻 System Requirements

Minimum:

• Python 3.9+
• Windows 10
• 200MB RAM
• 300MB disk space

Recommended:

• Python 3.11+
• Windows 11
• 500MB+ RAM
• SSD storage

For Gaming Analytics:

• NVIDIA/AMD GPU drivers updated
• DirectX 12 compatible system

📚 Documentation

• GETTING_STARTED.md - Installation & setup guide
• CHANGELOG.md - Version history & updates
• CONTRIBUTING.md - How to contribute
• docs/TECHNICAL.md - Architecture deep dive (coming)

👤 About

Marcin Firmuga | Software Engineer

Order picker by day, programmer by night.

• GitHub: HuckleR2003
• LinkedIn: Marcin Firmuga
• Email: firmuga.marcin.s@gmail.com

Part of HCK_Labs initiative.

📄 License

MIT License © 2025 HCK_Labs / Marcin Firmuga Free for personal and commercial use. Attribution appreciated.

Ship what you have. Improve it later. 💙