Skip to content

Commit ae24bd6

Browse files
HuckleR2003HuckleR2003
authored
Update 1.3.3
1 parent 1b66b98 commit ae24bd6

1 file changed

Lines changed: 228 additions & 0 deletions

File tree

‎README.md‎

Lines changed: 228 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,228 @@
1+
# PC_Workman_HCK
2+
**Part of [HCK_Labs](https://github.com/HuckleR2003/HCK_Labs)** – modular real-time system monitor and AI-assisted diagnostics framework.
3+
4+
Version: **1.3.3 (hck_GPT Integration & Performance Boost)**
5+
Author: **Marcin Firmuga (HCK_Labs)**
6+
Status: *Active Development – Educational AI Engineering Project*
7+
8+
---
9+
10+
## Overview
11+
`PC_Workman_HCK` is a real-time system monitoring tool built in Python.
12+
It combines **live performance diagnostics**, **data logging**, **AI-assisted analysis**, and a **modular architecture** designed for intelligent system optimization.
13+
14+
The project is part of the *HCK_Labs* initiative – an educational R&D effort focused on combining AI, system engineering, and cybersecurity practices.
15+
16+
## Screenshots
17+
Below are early UI prototypes from version 1.0.6:
18+
19+
| Main View | Processes Panel |
20+
|------------|----------------|
21+
| ![screen__v1](docs/screen__v1.png) | ![screen_v2](docs/screen_v2.png) |
22+
23+
---
24+
25+
## What's New in 1.3.3 🚀
26+
27+
### 🤖 hck_GPT Assistant
28+
Integrated AI assistant with two operational modes:
29+
30+
**Service Mode** (Active)
31+
- Interactive diagnostic wizards with context-aware questions
32+
- Intelligent service and process management
33+
- Safe rollback functionality for all system changes
34+
- Example: Bluetooth/Printer usage detection with automatic optimization
35+
- Clear warnings before applying changes
36+
37+
**ML/AI Mode** (Coming Soon)
38+
- Real-time performance bottleneck detection
39+
- Context-aware hardware utilization analysis
40+
- Personalized optimization recommendations based on usage patterns
41+
- Playful interaction: "Hey, torturing that i5 with Battlefield again? 14 hours this week, CPU is begging for mercy 😄"
42+
43+
### ⚡ Easy Boost Options
44+
One-click performance optimization with full transparency:
45+
- Quick gaming/boost mode toggle
46+
- Selective service and background process management
47+
- Visible changes with instant rollback capability
48+
- No "trust me bro" magic – everything is documented and reversible
49+
50+
### 🎨 UX Improvements
51+
- Refined UI with modern styling and improved readability
52+
- Better font rendering and visual hierarchy
53+
- Enhanced color schemes and contrast
54+
- Smoother animations and transitions
55+
56+
---
57+
58+
## Core Features
59+
60+
### 🔧 Modular Architecture
61+
- **Dynamic Component Registry:** automatic module registration via `import_core.py`, assigning unique identifiers (`py001_hck`, `json002_hck`, etc.).
62+
- **Seamless Interconnection:** all modules communicate through a central `COMPONENTS` registry for efficient data exchange.
63+
64+
### 📊 Core System
65+
- **Real-time data collection** using `psutil` and `GPUtil`.
66+
- Continuous **per-second sampling** of CPU, GPU, and RAM usage.
67+
- Minute-average aggregation and long-term logging (NOW / 1H modes).
68+
- Persistent logs saved in `/data/logs/` (`raw_usage.csv`, `minute_avg.csv`).
69+
- Lightweight background scheduler running at 1-second intervals.
70+
71+
### 💻 User Interface
72+
- Built with **Tkinter + Matplotlib**.
73+
- Live chart showing CPU, RAM, and GPU utilization.
74+
- Mode selector: `NOW`, `1H`, `4H` (NOW and 1H active).
75+
- Live side meter visualizing CPU and RAM usage.
76+
- Two data tables displaying top resource-heavy processes:
77+
- **User processes** (apps, tools, editors, etc.)
78+
- **System processes** (Windows core tasks)
79+
- Basic process labeling and icons (e.g. browsers ⚔️, explorer 📁, games 🎮).
80+
- Integrated `hck_GPT` assistant panel for system analysis and optimization.
81+
82+
### 🎓 Educational Value
83+
`PC_Workman_HCK` serves as a technical demonstration of:
84+
- modular code architecture,
85+
- GUI–data integration,
86+
- multithreaded scheduling,
87+
- AI module integration for offline diagnostic reasoning,
88+
- safe system optimization with rollback capabilities.
89+
90+
---
91+
92+
## Folder Structure
93+
```
94+
HCK_Labs/PC_Workman_HCK
95+
├────╮ Folder '__pycache__'
96+
│ └── `import_core.cpython-314.pyc`
97+
├────╮ Folder 'ai'
98+
│ ├── `__init__.py`
99+
│ ├── `ai_logic.py`
100+
│ ├── `detector.py`
101+
│ ├── `hck_gpt.py`
102+
│ └──────────────────╮ Folder '__pycache__'
103+
│ ├── `__init__.cpython-314.pyc`
104+
│ ├── `ai_logic.cpython-314.pyc`
105+
│ ├── `detector.cpython-314.pyc`
106+
│ ├── `hck_gpt.cpython-314.pyc`
107+
│ └─╮ `Folder 'model_cache`
108+
| └── `__init__.py`
109+
├────╮ Folder 'core'
110+
| ├── `__init__.py`
111+
| ├── `analyzer.py`
112+
| ├── `logger.py`
113+
| ├── `monitor.py`
114+
| ├── `scheduler.py`
115+
| └──────────────────╮ Folder '__pycache__'
116+
│ ├── `__init__.cpython-314.pyc`
117+
│ ├── `analyzer.cpython-314.pyc`
118+
│ ├── `logger.cpython-314.pyc`
119+
│ ├── `monitor.cpython-314.pyc`
120+
│ └── `scheduler.cpython-314.pyc`
121+
├────╮ Folder 'data'
122+
│ └──╮ Folder 'cache'
123+
│ ├── `runtime_cache.json`
124+
│ ├── `summary_temp.txt`
125+
│ └─╮ Folder 'logs'
126+
| ├── `daily_usage.csv`
127+
| ├── `hourly_usage.csv`
128+
| ├── `minute_avg.csv`
129+
| ├── `monthly_usage.csv`
130+
| ├── `raw_usage.csv`
131+
| ├── `weekly_usage.csv`
132+
| └─╮ Folder 'process_info'
133+
| ├── `process_patterns.json`
134+
| ├── `processes_today.json`
135+
| └── `processes_total_average.json`
136+
├────╮ Folder 'docs'
137+
│ ├── `dev-structure.txt`
138+
│ ├── `how_it_works_cross.txt`
139+
│ ├── `screen_v1.png`
140+
│ ├── `screen_v2.png`
141+
| └── README_PL.md
142+
├────╮ Folder 'hck_stats_engine'
143+
| ├── `__init__.py`
144+
| ├── `avg_calculator.py`
145+
| ├── `time_utils.py`
146+
| ├── `trend_analysis.py`
147+
| └──────────────────╮ Folder '__pycache__'
148+
| ├── `__init__.cpython-314.pyc`
149+
| ├── `avg_calculator.cpython-314.pyc`
150+
| └── `trend_analysis.cpython-314.pyc`
151+
├────╮ Folder 'settings'
152+
| ├── `config.json`
153+
| ├── `paths.json`
154+
| └── `user_prefs.json`
155+
├────╮ Folder 'tests'
156+
| ├── `test_analyzer.py`
157+
| ├── `test_avg_calculator.py`
158+
| └── `test_monitor.py`
159+
├────╮ Folder 'ui'
160+
│ ├── `charts.py`
161+
│ ├── `dialogs.py`
162+
│ ├── `main_window.py`
163+
│ ├── `theme.py`
164+
│ └──────────────────╮ Folder '__pycache__'
165+
│ └── `main_window.cpython-314.pyc`
166+
├────╮ Folder 'utils'
167+
| ├── `file_utils.py`
168+
| ├── `net_utils.py`
169+
| └── `system_info.py`
170+
├──`CHANGELOG.md`
171+
├──`import_core.py`
172+
├──`README.md`
173+
├──`requirements.txt`
174+
├──`setup.py`
175+
└──`startup.py`
176+
```
177+
178+
---
179+
180+
## Installation
181+
182+
### Requirements
183+
- Python **3.9+**
184+
- Recommended packages:
185+
```bash
186+
pip install psutil gputil matplotlib
187+
```
188+
189+
### Running
190+
Launch from terminal:
191+
```bash
192+
python startup.py
193+
```
194+
195+
If GUI is available, the live interface will open.
196+
197+
In environments without Tkinter (e.g., servers), the program automatically switches to headless mode, collecting and logging resource data silently.
198+
199+
---
200+
201+
## Roadmap - Updates
202+
203+
| Version | Status | Description |
204+
| ---------- | -------------- | ----------------------------------------------------- |
205+
| v1.0.0 | Released | Basic architecture and mock data prototype |
206+
| v1.0.4 | Stable | Early diagnostic demo with simulated data |
207+
| v1.0.6 | Stable | Real-time core + first working UI prototype |
208+
| v1.0.7 | Released | 4H mode, process patterns, basic `hck_GPT` framework |
209+
| **v1.3.3** | **Current** | **hck_GPT Service Mode, Easy Boost, UX overhaul** |
210+
| v1.4.0 | Planned | hck_GPT ML/AI Mode with usage pattern analysis |
211+
| v1.5.0 | Planned | Advanced bottleneck detection and recommendations |
212+
213+
---
214+
215+
## Author
216+
**Marcin Firmuga (HCK_Labs)**
217+
*AI & System Engineering – From Factory to AI Engineer*
218+
219+
- **LinkedIn:** [Marcin Firmuga](https://www.linkedin.com/in/marcin-firmuga-a665471a3)
220+
- **GitHub:** [HuckleR2003](https://github.com/HuckleR2003)
221+
- **Email:** firmuga.marcin.s@gmail.com
222+
223+
---
224+
225+
## License
226+
**MIT Educational Open License**
227+
Non-commercial, attribution required.
228+
© 2025 HCK_Labs / Marcin Firmuga.

0 commit comments

Comments
 (0)