Your PC finally has someone who speaks its language.
Or download the latest release, one ZIP, no installer, no account.
pcworkman.dev - website, guides, and the build-in-public blog (Monday / Wednesday / Friday).
Most monitoring tools give you numbers. PC Workman gives you answers.
Ask "why is my PC slow right now?", and get a real explanation, not just a percentage.
Ask "is cs2.exe a virus?", get an instant process identity check.
Ask "which game pushes my hardware the hardest?", get a thermal signature breakdown.
90 AI intents. The assistant runs 100% on your machine, no API key, no cloud LLM. Just your PC talking to you.
It learns your machine: 82°C is normal while you game but critical at idle, judged against your own history, not a generic 85°C line. Drop an in-game overlay that shows only what you choose, hit ⤢ for a full-screen control center, and watch the Learning Center fill up as it gets to know your hardware. Built by one person, in public, on real hardware.
| Traditional tools | PC Workman HCK |
|---|---|
CPU: 87% |
"CPU at 87% — Chrome and Electron processes, consider closing Discord" |
| Static charts | Pan/zoom charts: click any point, see pinned tooltip with baseline context |
| Dumb thresholds | Learns your hardware's normal temperatures per workload — gaming vs idle |
| Voltage: raw numbers | SPC control limits — flags deviations, not just ATX spec crossings |
| No context | Remembers patterns, compares today vs your 7-day average |
| Manual checks | Proactive alerts: voltage anomaly? temperature spike? process appeared? Auto-pushed |
| English only | Polish + English, auto-detected per message |
1. Download PC_Workman_HCK_1.8.2.zip from Releases
2. Extract the folder anywhere
3. Run "PC Workman HCK.exe" and you are done.
(keep the _internal folder next to it — that's the runtime)
git clone https://github.com/HuckleR2003/PC_Workman_HCK.git
cd PC_Workman_HCK
pip install -r requirements.txt
python startup.pyFull setup guide: GETTING_STARTED.md
- Real-time CPU, GPU, RAM tracking
- Network bandwidth per-application
- Process identification and labeling
- Temperature monitoring with trends
- Historical data logging (daily, weekly, monthly)
- One click (⤢) turns the compact 1160×575 dashboard into a full-screen control center
- Symmetric layout: TOP 8 user processes left, TOP 8 system processes right, chart hub in the middle
- Hardware cards grow into mini-charts with the component name drawn inside the chart corner
- hck_GPT chat scales with the window: +12% default height, +35% in chat-Maximize
- Gaming-HUD chart tooltip: hover to inspect any bar at 72% opacity, click to pin, the pin follows the live buffer and its age keeps ticking
- 90 intents across 8 categories (hardware, diagnostics, performance, why, optimization, security, fun, small talk) + gaming/battery/upgrade/privacy
- Hybrid Engine: rule-based responses for known intents, Ollama LLM for open-ended questions, 100% offline, no API key needed
- Bilingual: Polish and English, auto-detected per message
- Session memory: conversation context, CPU/RAM trend buffers, cross-response data store
- Proactive monitor with DeepMonitor integration: background daemon watches CPU/GPU temps, RAM, throttle, disk on all drives; pushes alerts automatically; banner shows live temps
- Conversation flow: greeting, thanks, "more info", "what should I do" all handled naturally with context-aware routing
- Local insights engine, habit tracking, anomaly awareness, teasers from Stats Engine
- SQLite user knowledge base (hardware profile, usage patterns) at
AppData/Local/ - Background hardware scanner (psutil + WMI, CPU model, GPU, VRAM, mobo, RAM speed, disk model)
- Chat panel nav links: clickable
[→ Page]tokens route directly to app pages _followup()pool system: 8 keys, every response ends with a contextual next-question hint
- Interactive charts (
ui/components/interactive_chart.py): pan (drag), zoom (scroll wheel around cursor), reset (double-click), crosshair + live value bubble, click-pin persistent tooltip with anomaly reason and baseline deviation - Minimap strip below each chart, full data range with drag-to-navigate selection window
- Thermal Baseline Engine (
core/thermal_baseline.py): learns CPU temperature norms per workload context (idle / light / medium / heavy / gaming) with a true Welford online accumulator, running per-bucket stats that accumulate over the whole install life and survive 90-day snapshot pruning, not a fixed window. Chart baseline band shows the learned range, not a window average. - Voltage Rail Analyzer (
core/voltage_analyzer.py): SPC on 12V / 5V / 3.3V rails using Median + MAD. Nelson Rules 1/2/3/5 (isolated spike, cluster, sustained deviation, trend). 12V GPU-transient suppression. Anomaly decay: pattern repeats ≥5× → "your normal". - Learning Center: per-workload thermal training progress + learned ranges, per-rail voltage SPC baselines, overall %, live PSU health score, and a ↻ Rebuild self-check.
- hck_GPT integration:
_check_voltage_rails()firesvoltage_spike/voltage_trendproactive alerts (bilingual, budget-controlled).format_for_chat(lang)on VoltageAnalyzer. - Dashboard chart tooltip: hover any bar → translucent detail box (CPU/RAM/GPU% + sample age) next to the cursor. Click to pin, the tooltip docks to its bar, the age ticks live, and the PIN strip mirrors the hck_GPT TIP/HOT style. Click anywhere to unpin.
ttk.Treeviewsensor table with 4 aligned columns (Sensor / Value / Min / Max)- Type-specific row background tints: temperature = blue-night, utilization = indigo
- Action bar: Save Data (.txt/.csv), Pause, Reset min/max
- Sub-section headers color-coded by metric type
- 2.5D isometric view of your PC rendered via Pillow (2× SSAA, LANCZOS downscale)
- Desktop PC mode: case, mobo, CPU + heatsink, GPU, RAM, SSD, PSU, fans, cables
- Laptop mode: open chassis with mobo, fans, GPU, battery, screen, keyboard
- Components color-shift green → amber → red based on live heat/load; hot components pulse
- Hover over any component for a tooltip with live stats
- Auto-refresh every 3 seconds via background thread
- Interactive 3-step spotlight overlay (
ui/guide/live_guide.py) launched from Guide page - Windows
-transparentcolortechnique: dim full screen, punch transparent hole over target widget - Step 1: main realtime chart + time-filter buttons; Step 2: left/right nav buttons with per-button descriptions; Step 3: hardware cards + session averages
- Floating info card with accent bar, step dots, DALEJ / Zakończ button; ESC or ✕ to dismiss
- Health score gauge (0–100 arc), computed from driver ages and startup count
- 4 driver health cards: GPU, Audio, Network, USB, real data from Windows registry
- Driver freshness bar per card; status badges: CURRENT / 6+ MONTHS / Xmo OLD
- Startup program list (registry HKCU/HKLM Run keys), 6-item setup checklist with persistent state
- Quick Actions: Windows Update, Device Manager, Services, Task Scheduler, System Info, MSConfig
- Reads every startup source: HKCU/HKLM/HKLM32 Run keys, Startup folders, Task Scheduler logon/boot tasks, and Microsoft Store (UWP) startup apps, so GPU Tweak, ShareX, LinkedIn, MSI Center and the like finally show up
- Knowledge base of common programs with impact rating (High/Medium/Low) and recommendation
- Reversible enable/disable per source (registry removal ·
schtasks· UWP state); locale-independent task scan works on non-English Windows; choices persist todata/cache/startup_prefs.json
- Catalogue of 40+ Windows services in 4 categories (Essential locked / Recommended / Optional / Likely Unnecessary), plus enumeration of every installed service
- Guided Quick setup strip: plain questions ("Do you use Bluetooth?") build your custom profile
- Per-service G / E / M chips assign each service to the Gaming · Economy · MANAGER modes, one source of truth, synced live with the Features mode buttons (
settings/turbo_services.json) - Stop / Start / Restart per service; admin detection; all changes logged to
data/logs/service_changes.log
- Modern dashboard (Apple-inspired design)
- Ultra-compact information density
- Color-coded process lists
- Interactive charts and metrics
- Click-to-investigate functionality
- Process tooltips on TOP 5 panels, hover any process name for instant library lookup
- Monitoring & Alerts layout polish pass
- Per-rail voltage history export (CSV)
Modular, scalable design:
PC_Workman/
├── core/
│ ├── monitor.py # psutil snapshot every 1s (background thread)
│ ├── scheduler.py # drives aggregation ticks
│ ├── thermal_baseline.py # workload-aware temp learning — Welford accumulator, 5 buckets
│ ├── voltage_analyzer.py # SPC on 12V/5V/3.3V — Median+MAD, Nelson rules 1/2/3/5
│ └── hibernation_manager.py # SetPriorityClass + NtSuspendProcess for Turbo Mode
├── hck_gpt/
│ ├── engine/ # Hybrid Engine: rule routing + Ollama LLM client
│ ├── intents/ # Intent parser, ML classifier (Naive Bayes), vocabulary, lang detect
│ ├── memory/ # Session memory, user knowledge (SQLite), proactive monitor
│ ├── context/ # System context builder, hardware scanner
│ ├── responses/ # Bilingual response builder (5600+ lines, 70+ handlers)
│ ├── chat_handler.py
│ ├── insights.py # InsightsEngine (habits, anomalies, teasers)
│ └── panel.py # Chat panel UI
├── hck_stats_engine/ # SQLite pipeline: minute/hourly/daily/monthly stats
├── ui/
│ ├── windows/ # Main window modes (expanded, minimal)
│ ├── guide/ # Interactive spotlight guide (LiveGuide, 3-step tour)
│ ├── components/ # interactive_chart.py, pc_map.py (2.5D isometric), LED bars, tooltips
│ └── pages/ # Full-page views (monitoring, fan control, startup, services)
├── 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)
- Direct inter-module communication
- Designed for future expansion
- Educational value (demonstrates Python best practices)
- Services Manager rebuilt as a real configurator: one Wyłącz/Włącz per service feeds a single operator drawer at the bottom of the page, and Zatwierdź applies the whole batch at once, no more per-row dialogs or truncated service names. SZCZEGÓŁY expands the queued list inline.
- Hardware detection fixed for Windows 11 24H2+ (build ≥ 26100), where
wmic.exewas removed, My PC → Components now fills in CPU / GPU / RAM / motherboard / disks via a PowerShell CIM fallback. - Fixed a Features-page crash, made expanded feature cards widen for readability, scoped Services Manager scrolling to the page, and hardened
sc/ PowerShell output decoding so unusual service names can't crash a reader thread.
- hck_GPT now answers temperature with the learned, workload-aware verdict instead of a fixed 85°C cutoff: 82°C reads normal under a gaming load but critical at idle. "voltage check" got its own real handler (was silently aliased to the temperature one). The chat handler imported neither learning engine before, months of learning it couldn't reach.
- The proactive monitor judges CPU temperature against the learned per-workload baseline (z-score), falling back to fixed thresholds until a bucket is trained, so it stops crying wolf during normal gaming. Elevated-but-safe goes out as a 💡 TIP, not an alarm.
- Thermal baseline is a real Welford accumulator now: each pass folds only the newest snapshots into a running per-bucket
{n, mean, M2}, so learning accumulates for the life of the install and survives 90-day pruning, and a continuous tick in the proactive loop keeps it learning while the app runs. - Learning Center in Monitoring & Alerts shows live what was learned: per-workload thermal progress + ranges, per-rail voltage SPC baselines, overall %, PSU health score, and a ↻ Rebuild self-check.
- Voltage rail health now counts genuine Nelson-rule anomalies (after GPU-transient suppression + recurrence decay), not the ~1.2% Gaussian tail, a healthy rail no longer reads "critical" once enough samples pile up.
- hck_GPT volunteers two positive learning notes: a one-time 💡 when a workload reaches full calibration ("I now judge temperature against YOUR normal"), and a 💡 "new normal" when a recurring voltage blip becomes your baseline. Both deduped so they never nag.
- New GAMING / In-Game tile in My PC: a translucent always-on-top HUD that floats over borderless / windowed games without stealing focus. Left/right-click moves it between the four corners.
- Real HUD table, one row per component (CPU / GPU / RAM / 12V), FPS as a side box, with live values.
- A form-style configurator: 3 presets, or Create Custom where each field is a ▼ dropdown to pick the metric per row, plus a style panel (size / theme / opacity). Live preview matches the overlay 1:1.
- Live FPS read from RTSS (RivaTuner / MSI Afterburner), no admin, no DLL injection; shows "-" when RTSS isn't running. Per-pixel transparency is on the way.
- Game launch greetings: a one-second corner toast when a known game starts, now bilingual (PL/EN) with random variants across 40+ games (Planet Zoo, Terraria, Minecraft, Helldivers 2, GTA V, Hades…).
- Now enumerates Task Scheduler logon/boot tasks and Microsoft Store (UWP) startup apps, not just Run keys + Startup folders. GPU Tweak, ShareX, LinkedIn, MSI Center and others finally appear, each with a reversible enable/disable and a source badge (⏰ Task · ⊞ Store).
- Rebuilt as a configurator: per-service G/E/M chips assign services to Gaming, Economy or the new custom MANAGER mode, plus a guided question strip. All modes share one config, synced live with the Features buttons.
- New MANAGER mode in Features (white chip) with a click-through ⓘ that jumps to the Services Manager.
- Process Suspect Guard mini-AV: author (Authenticode) verification, typosquat/homoglyph detection (svhost, ciaude…) and masquerade checks, wired into "virus check" and process identity.
- Natural-language routing overhaul (everyday phrasings hit the right intent) and purple highlighting of hardware names in chat.
- Four new data-driven answers: "what should I upgrade?" (the real bottleneck from your own load + temperature history), "do you spy / what do you collect?" (honest, local-only, links to Stability Tests), greetings that name your favourite app ("Fancy CS2 again today?"), and "what starts with Windows?" (your real startup list, links straight to the Manager). Vocabulary now 90 intents.
- Symmetric full-screen dashboard: TOP 8 user processes left, TOP 8 system right, chart hub center
- Hardware cards: 50px sparklines with the component name drawn inside the chart corner
- Turbo Boost + Optimization Center docked at the bottom; session averages section +15% taller
- hck_GPT chat scales with the window: +12% default open height, +35% in chat-Maximize
- Hover any bar → translucent (72% opacity) detail box follows the cursor: CPU/RAM/GPU% + sample age
- Click to pin: tooltip docks to its bar, age ticks live, pin index follows the LIVE ring buffer
- PIN strip styled like the hck_GPT TIP/HOT strips; any click unpins; cleared on page switch
- Fixed: sample age was reported ×2
- Chat banner now available on MY PC and FAN DASHBOARD, not just the dashboard
- Visibility gate prevents the banner from leaking onto other pages
- TOP 8 scroll fixed (global wheel binding died over child rows) + honest
<1%values - 1326 lines of dead code removed from the main window; 10+ resource leaks fixed (stacked wheel bindings, orphaned threads, uncancelled timers)
- hck_GPT banner gradient: persistent rects recolored via
itemconfiginstead of delete+create at 10 fps; sweep idles while hidden - Window-state fixes: minimal → expanded works after a maximize round-trip; banner no longer unclickable after restore
See Features → Monitoring & Alerts for full detail.
- Thermal Baseline Engine: workload-aware temperature learning, 5 buckets (idle/light/medium/heavy/gaming), Welford's algorithm, 95% confidence band on charts
- Voltage Rail Analyzer: SPC on 12V/5V/3.3V, Median+MAD, Nelson Rules 1/2/3/5, GPU-transient suppression, anomaly decay
- Interactive charts: pan (drag), zoom (scroll), click-pin tooltip with anomaly reason, minimap navigation strip
- hck_GPT proactive alerts:
_check_voltage_rails()firesvoltage_spike/voltage_trend, bilingual, session budget + gap protected
- 13 bug fixes including: Bessel's correction for sample variance, per-rail
"latest"key in anomaly summary, deadif False else 0predicate inget_summary_stats(), duplicate stopword in ML classifier, font loaded from disk on every 120ms frame,_gather_live.__call__()wrong method access form - 8 innovations:
overall_health_score()(PSU 0-100),format_for_chat()on thermal and voltage,get_top_k()(intent classifier debug),_thermal_aware_cpu_heat()(z-score coloring),cleanup_dead_pids(),get_savings_estimate(),_downsample()bias fix (round()vsint()) - All 6 modules verified clean with
python -m py_compile
- Detects driver packages left in Windows after replacing hardware (e.g. old GT 1030 after upgrading to RTX 3050)
- Uses
pnputil /enum-devices /connected, only physically present hardware, not phantom registry entries - Ghost entries shown on driver cards with bordeaux background and
⚠ GHOST/100% UNUSEDbadge, visible without expanding - Dialog: device age, version, explanation; option to remove via
pnputil /remove-device(admin + confirmation) - Works across GPU, Audio, Network, USB driver classes
- Two mode buttons in DRIVER HEALTH header: SEE EVERYTHING (all devices by category) and SEE OUTDATED (N) (drivers 24+ months old, sorted oldest first)
- Expand button per card:
▼ pokaż wszystkie (N)reveals every device found in that class, ghost devices highlighted in bordeaux - Drivers >= 730 days (~24 months) marked red
- Bordeaux exclusion panel inside RAM Flush card: click any process to protect it from flush
- Protected processes persist across restarts via
user_prefs.json - Flush result shows protected count:
Freed 420 MB (87 procs · 3 protected)
- MAP OF COMPONENTS: case_front panel removed (was covering internals in screen-space); replaced with thin corner rails
- hck_GPT HOT strip: removed duplicate panel-side monitor that conflicted with proactive_monitor and had broken Polish strings
- Startup Manager: admin notice now amber and prominent, matching Services Manager style
ram_flushintent alias fixed: routes tooptimization(actionable) instead ofram_why_high(diagnosis)
- Startup Manager: renamed "Needs Attention" → "Startup Menu"; removed non-functional "All entries" panel; auto-refresh after restoring a disabled entry
- Services Manager: always shows both Stop and Start buttons for every non-essential service, active button is colored, inactive is muted (was showing only one direction)
- Services Manager: expand banner now says
∨ Rozwiń więcej (N) ∨and is more compact - First Setup & Drivers: GHOST badge now visible immediately on card header (not only inside expanded panel); subcategory labels and expand buttons are clearly readable; ghost devices highlighted bordeaux inside expand panel
- Page headers: compact
← Główne Menuonly, removed redundant large title/subtitle duplication below the title bar
ttk.Treeviewsensor table with 4 aligned columns (Sensor / Value / Min / Max)- Type-specific row background tints: temperature = blue-night, utilization = indigo
- Action bar: Save Data (.txt/.csv), Pause, Reset min/max
- Sub-section headers color-coded by metric type
- 2.5D isometric view of your PC rendered via Pillow (2x SSAA, LANCZOS downscale)
- Desktop PC mode: case, mobo, CPU + heatsink, GPU, RAM, SSD, PSU, fans, cables
- Laptop mode: open chassis with mobo, fans, GPU, battery, screen, keyboard
- Components color-shift green -> amber -> red based on live heat/load; hot components pulse
- Hover over any component for a tooltip with live stats
- Auto-refresh every 3 seconds via background thread
- 6 new intents:
game_can_run,gaming_ram_usage,daily_ram_usage,battery_estimate,upgrade_feasibility,top_resource_hog - Conversation flow: greeting/thanks/more-info/what-should-I-do routing
- 82 intents total (up from 76)
- Language sync: panel language now follows Settings page in real-time
- All UI files now use the shared
_HDR/_BODY/_MONOsystem fromutils/fonts.py - Inter font (if available) applied consistently across all 30+ UI files
- Zero hardcoded
"Segoe UI"/"Consolas"strings remaining in UI layer
- 241 -> 373 entries (+132 entries: Signal, Viber, Bitwarden, Godot 3/4, Unreal Editor, RDR2, Horizon ZD/FW, Helldivers 2, and many more)
Built from 28 real community requests (GitHub Discussions + LinkedIn).
- 13 new intents: fan noise history, driver status, gaming vs work time, process identity, stale apps, FPS degradation, app behavior change, startup slowdown, temp comparison, crash context, game hardware stress, battery drain rate, power after restart, 63 → 76 intents total
- Context Time-Windowing: each intent gets a history window (5 min → 7 days); LLM context is scoped to what's actually relevant for that question
- No-AI-Slop fallback: when data is missing, the AI says so instead of making things up
- Time-Travel Debugging: compare any live metric to its N-day historical average
- Micro-Benchmarking: background cpu/disk benchmarks triggered on demand, stored in session memory
- 104 → 241 entries, games (CS2, Elden Ring, Cyberpunk, BG3, KSP…), dev tools (JetBrains suite, Cursor, DBeaver…), RGB software, diagnostics, VPN/network, Windows system processes
- Feature grid rebuilt as 2-column expandable card layout, each card has an inline info panel, no separate overlay
- Snapshot strip (CPU / RAM / Disk) now shows subtle fill bars behind the percentage values
- Turbo Power Plan now actually creates a "Turbo PC" power scheme via
powercfg; handles non-English Windows, detects missing admin rights, restores original plan on exit - Quick Actions replaced: Startup Manager (nav), Services Manager (nav), Disk Defragmenter (run), Weekly Performance Report (window)
- Weekly Performance Report: 6 bar charts (CPU/GPU/RAM avg + peak over 4 rolling weeks), AI text summary, TXT export
- LIVE NOW sidebar: CPU/RAM/GPU mini-bars, refreshes every 2 s
- Typography upgrade: Segoe UI Semibold throughout; fixed icon widget parenting bug
- "More Optimization Tools" button replaced with a subtle dark "Optimization Center" chip, navigates to My PC → Hardware & Health; glow animation removed
yourpc_page.pynow uses the sharedutils.fontsfont system (_HDR / _BODY / _MONO)
- New
ui/guide/live_guide.py,LiveGuideclass: interactive spotlight overlay with Windows-transparentcolordim technique - 3-step dashboard tour: chart + filters → nav buttons (left/right) with per-button descriptions → hardware cards + session averages
- Floating info card: accent bar, badge, step dots, DALEJ/Zakończ; ESC or ✕ to dismiss
- Wired to "▶ Guide on program LIVE" button in Guide page; auto-returns to dashboard and waits for widgets
_resp_helpfully rewritten: 8 sections with emoji headers covering all 37 intents (hardware, diagnostics, performance, why, optimization, security, fun, small talk), bilingual PL/EN_resp_optimizationrewritten with live data: real CPU/RAM snapshot, hardware-profile flags (HDD, low RAM, few cores), priority tip (🔴/🟡/✓), conditional virtual-memory and HDD notes_FOLLOWUPSpool expanded 3 → 8 keys (hw,health,perf,security,disk,why,process,session);_followup()wired into 9 handlers (virus_check,disk_health,disk_usage_why,battery_drain,uptime,process_info,throttle_check,perf_change,session_compare)record_response_dataadded tohw_gpu,perf_change,session_compare, AI can now reference GPU model/VRAM and yesterday's stats in follow-up answers
- WMI hardware scanner: RAM speed + part number, primary disk model added to user knowledge base
- Session data store (
session_memory.record_response_data/get_response_data/discussed_this_session), cross-response referencing system - Chat panel nav links (
_apply_nav_links):[→ Page]tokens in AI responses are clickable and route directly to app pages;register_nav_callback()API;_open_virtual_memory()helper
- New Startup Manager page: reads registry Run keys, rates impact (High/Medium/Low), three panels (Optimize / Safe to disable / All), confirm-before-remove, prefs persisted
- New Services Manager page: 40+ services catalogued, Stop/Start/Restart, admin detection, TURBO Mode integration (queue services for auto-stop), change log
- Replaced single "Optimization & Services" button with 3-zone Optimization Hub: Optimization Center (left), Startup Manager (top-right), Services Manager (bottom-right), single Canvas with zone detection, hover brightening, live metrics in daemon thread
- Removed hck_GPT banner from Central tab; added SESSION bar (
SESSION: Xh Ym+● LIVE) - Nav bar: MY PC label (Inter Bold), tab/section fonts upgraded to Inter
- Stability Tests + Your Account moved to bottom row (side by side)
- Fixed
_show_help()always responding in wrong language (used pre-detectionself._last_lang) - Redesigned
_show_help()with◈category headers, bilingual PL/EN - Fixed
_resp_temperature(), DB fallback viaquery_apiwhenpsutil.sensors_temperatures()empty on Windows - Fixed
_resp_speed_up_pc(), removed unconditional TURBO BOOST + FPS tips regardless of system state
get_temperature_history(),get_temperature_summary(),get_top_processes_lifetime(),get_weekly_summary()
- All versions aligned to 1.7.2;
requirements.txtcompleted;PCWorkman.specfully rewritten (25+ hidden imports,settings/bundled); EXE build:dist/PC_Workman_HCK_1.7.2/(~94 MB) ✅ - Codebase cleaned: removed all "Apple style", "Inspired by", TODO comments
- Bordeaux Noir panel: animated black→crimson gradient banner with sine-wave shimmer,
AIvector badge, pulsingONLINEbadge, no image files - Hybrid Engine (
hck_gpt/engine/): routes low-confidence / open-ended messages to Ollama LLM (local), rule engine handles everything else; graceful 60s cooldown on Ollama unavailability - Bilingual responses: every handler now replies in Polish or English based on auto-detected language;
random.choice()pools for variety - Proactive monitor: background daemon watches CPU, RAM, throttling, disk, session uptime; pushes alerts to chat panel and banner status bar
- Session memory extended: CPU/RAM trend buffers, auto conversation summary every 6 messages,
get_context_for_llm()injected into Ollama system prompt - Rich system context: top 3 processes, temperature readings, 6-section LLM context string (live state, today's averages, processes, temps, hardware profile, conversation)
- User knowledge base: SQLite at AppData, hardware profile, facts, usage patterns; background hardware scan via psutil + WMI (CPU model, GPU, VRAM, motherboard, RAM speed)
- Parser improvements: ASCII-fold dual scoring for Polish accent normalization; vocabulary enriched with multi-word phrases for reliable confidence above routing threshold
- Efficiency tab: fixed physical core count (was showing logical count); fixed invisible avg text color; per-core session min/max/avg; side-by-side TOP CPU/RAM consumers
- HCK_Labs globe icon: vector globe drawn with canvas primitives, sphere + meridian + equator + parallels
- Dashboard nav buttons full redesign (dark-gradient, accent stripe, bordeaux L-brackets, vector icons)
- HCK_Labs and Guide pages full blog-style redesign
- Navigation routing fixes (MONITORING, AllMonitor, overlay title)
- Turbo Boost set to coming-soon state with tooltip
- Optimization Center redesign: TURBO BOOST button, feature count badge, column layout, RAM Flush card
utils/fonts.py, Inter font via GDI32 with Segoe UI fallback- Repository cleanup: proper
.gitignore, 7 dead files removed, broken imports fixed,__pycache__cleared
- First Setup & Drivers page: health score gauge, 4 driver health cards (registry data), setup checklist with persistent state
- hck_GPT chat time badge (inline canvas, per-message
HH:MM) - Process library expanded (+8 entries); process tooltips on TOP 5 panels
- 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
- 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
- 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
- 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)
- 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)
- Dashboard-only updates:
_update_hardware_cardsand_update_top5_processesguarded bycurrent_view == "dashboard" winfo_exists()guards on all widget update methods- Fixed routing IDs for new subitems (temperature, voltage, alerts)
- 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
- All time filters working: LIVE, 1H, 4H, 1D, 1W, 1M
- Pulls real data from
hck_stats_engineSQLite (minute/hourly/daily tables) - Auto-refresh historical data every ~30s
- Lifetime uptime persists across sessions (shutdown flush + multi-table query)
- System idle process filtered at source (no more "1012% CPU" messages)
- 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
- Complete visual redesign with purple gradient temperature graph
- Improved data density and readability
- Enhanced visual hierarchy with gradient-based design language
- 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)
- Replaced hardware cards with feature-focused navigation menu
- Five interactive menu buttons with background graphics:
- YOUR PC - Health Report - Component health monitoring with session history
- Statistics & Monitoring - Monthly statistics with spike detection
- Optimization Dashboard - Automated optimization for legacy hardware
- Daily Advanced System Cleanup - Consolidated cleanup utilities
- 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
- 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)
- 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
Fan Dashboard Evolution - Complete overhaul (3 iterations in one night!) - General fixes
-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
-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
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"
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
- 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
- Three-column layout (CPU | RAM | GPU)
- Real hardware names (actual Intel/AMD/NVIDIA)
- Intelligent load classification (Normal → Critical)
- Temperature bars with heat-based coloring
- Per-game performance tracking
- FPS correlation with system load
- Bottleneck detection
- Thermal signature per game
- Windows services management
- Gaming mode toggle
- Startup programs cleanup
- Safe system optimizations with rollback
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/ # Fan curves & hardware
│ ├── startup_manager.py # Startup programs manager (new)
│ ├── services_manager.py # Windows services + TURBO (new)
│ ├── optimization_services.py # Optimization Center
│ └── first_setup_drivers.py # Driver health & checklist
├── 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
- Python 3.9+ (or use .exe)
- Windows 10+ (Linux/Mac support coming)
- RAM: 200MB minimum
- Disk: 300MB (if using .exe installer)
# 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.pyDownload from Releases → Double-click → Done
- Dashboard opens showing real-time metrics
- Give it 5 seconds to collect initial data
- CPU/RAM/GPU bars populate
- Click tabs to explore features
- 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
- Green (0-30%) - Normal operation
- Yellow (30-60%) - Moderate load
- Orange (60-85%) - Heavy load
- Red (85%+) - Critical
- CPU/GPU/RAM usage (on your device only)
- Process names (to identify running applications)
- Temperature readings (from hardware sensors)
- Network usage (local tracking)
- Local only:
/data/logs/hck_stats.db(SQLite) + learned baselines in/data/cache/ - Never personal: no files, keystrokes, browsing, or content, ever
- You control the network: every outbound connection goes through one gate in Settings; turn it off and the app makes zero connections
- You control the data: delete
/data/anytime to start fresh
- All monitoring runs locally on your machine
- Open source, the code is auditable
- Network access is optional and off-able in Settings (off = firewall-verifiable zero traffic)
| 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.7.1 | Released | Stats Engine v2, Time-Travel, Monitoring |
| v1.7.2 | Released | Startup/Services Manager, Optimization Hub, hck_GPT AI layer, Hybrid Engine (Ollama), bilingual, EXE build |
| v1.7.3 | Released | Live Guide, hck_GPT AI quality (followups, help rewrite, optimization live), session data store, WMI scan, nav links |
| v1.7.4 | Released | Optimization Center redesign (2-col grid, expandable cards, Turbo PP creation, Weekly Report, LIVE NOW), dashboard button restyle |
| v1.7.5 | Released | hck_GPT 13 new intents (community requests), 4 MEGA features (Time-Windowing, No-AI-Slop, Time-Travel Debug, Micro-Bench), process library 104->241 |
| v1.7.6 | Released | DeepMonitor rewrite (Treeview), MAP OF COMPONENTS (2.5D isometric), hck_GPT Wave 2 (6 intents, 82 total), font system 100% coverage |
| v1.7.7 | Released | Ghost Driver Detection (pnputil), RAM Flush exclusion menu, SEE EVERYTHING/OUTDATED driver views, HOT strip stability, MAP fix |
| v1.7.7-patched | Released | UI/UX fixes: Startup Manager redesign, Services Manager stop/start logic, Drivers page readability, compact headers |
| v1.7.8-monitoring | Released | Thermal Baseline Engine, Voltage Rail Analyzer (SPC + Nelson rules), interactive pan/zoom charts, proactive voltage alerts, 6-module code-quality pass |
| v1.7.9 | Released | Maximized View Mode redesign, gaming-HUD chart tooltip, hck_GPT on MY PC / Fan tabs, 1326 dead lines removed, 10+ resource leaks fixed |
| v1.8.0 | Released | Smart Learning (Welford accumulator, workload-aware temps, voltage SPC), GAMING in-game overlay + configurator, live FPS via RTSS, 40+ game greetings, 4 new hck_GPT intents, Process Suspect Guard |
| v1.8.1 | Current | General fixes from Users feedback |
| v2.0.0 | Q2 2026 | Microsoft Store, long-term drift, Smart User Activity |
- Found a bug? Open Issue
- Have an idea? Start Discussion
- Want to help? See CONTRIBUTING.md
- We welcome pull requests
- Follow existing code style
- Include tests for new features
- Update documentation
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
- GETTING_STARTED.md - Installation & setup guide
- CHANGELOG.md - Version history & updates
- CONTRIBUTING.md - How to contribute
- docs/TECHNICAL.md - Architecture deep dive (coming)
Marcin Firmuga | Software Engineer
Building PC Workman in public, physical work by day, code by night.
- Website: pcworkman.dev
- Blog: Build-in-public series, Monday / Wednesday / Friday
- GitHub: HuckleR2003
- LinkedIn: Marcin Firmuga
- X: @hck_lab
- Email: firmuga.marcin.s@gmail.com
Part of HCK_Labs initiative.
MIT License © 2025 HCK_Labs / Marcin Firmuga Free for personal and commercial use. Attribution appreciated.
Ship what you have. Improve it later. 💙
