AI-powered Windows diagnostic & auto-repair tool using Google Gemini. Detect crashes, optimize performance, scan for malware, and generate PowerShell remediation scripts. Universal hardware support (1-128+ cores). Free & open-source.
SuperDiagnosticTool is an intelligent system diagnostic utility that combines real-time hardware telemetry with Google Gemini AI to analyze, diagnose, and automatically remediate Windows system issues. Built with a safety-first architecture, it provides production-grade diagnostics for any Windows configuration.
Screenshots
Main interface showing scan mode selection and problem description input
Key Features
Universal Hardware Support
Dynamic Scaling: Automatically adapts to any CPU configuration (1-128+ cores)
Hardware-Agnostic Logic: Works seamlessly on legacy systems (Intel Pentium) to high-end workstations (AMD Threadripper, Intel Xeon)
Graceful Fallbacks: Safe handling of unsupported features (CPU frequency, battery detection, swap memory)
Low-Spec Optimized: Lightweight execution prevents system lags even on resource-constrained hardware
Intelligent AI Analysis
Google Gemini Integration: Advanced AI-powered system analysis and diagnostics
Context-Aware Recommendations: Correlates user-reported issues with system telemetry
Security Auditing: Scans for suspicious processes, resource leaks, and potential malware
Post-Fix Verification: Generates completion reports showing what was fixed vs. what requires manual attention
Safety-First Architecture
Production-Grade Security (85%)
Multi-Layer Validation
Knowledge Base Matching: Validates AI solutions against 5 tested, known solutions with success rates
Dry-Run Simulation: Preview all changes before execution (services, files, registry)
Multi-Level Script Validation: Blacklist, whitelist, and risk scoring (0-100)
System Restore Points: Automatic restore point creation before any modifications
Enhanced Monitoring
Pre/Post Execution Snapshots: Complete system state capture before and after changes
Change Detection: Automatic tracking of all modifications (services, registry, startup items)
Rollback Generation: Auto-generated scripts to undo changes if needed
Execution Logging: Comprehensive logs of all operations
PowerShell Safety
Admin Privilege Verification: All remediation scripts include elevation checks
Variable Sanitization: Regex-based escaping prevents errors while preserving $env: variables
Service Safety Checks: Verifies service existence before operations
Sandbox Execution: Monitored environment with timeout protection
Error Handling: Comprehensive try-catch blocks with safeguards
Comprehensive System Scanning
Performance Metrics: CPU usage (overall + per-core), memory breakdown, top resource consumers
Network Intelligence: Active interfaces, DNS configuration, Wi-Fi signal strength, connectivity tests
Security Integrity: Antivirus status, firewall profiles, Windows Update history
Hardware Health: Disk SMART status, GPU information, battery status (laptops)
System Services: Startup applications, failed services, critical event logs
Process Auditing: Identifies suspicious processes based on resource usage and location
Human-Centric Reporting
Professional HTML Reports: Dark-themed, responsive diagnostic reports with visual metrics
Past-Tense Completion Language: Reports use [FIXED], [CLEANED], [DISABLED] tags to show completed actions
Manual Attention Section: Clearly separates automated fixes from items requiring user intervention
Timestamped Archives: All reports saved to AI_Reports/ directory for historical tracking
This tool generates and executes PowerShell scripts that modify system services, configurations, and settings. While designed with safety-first principles:
Always review the generated PowerShell script before execution
Backup critical data before running automated remediation
Test on non-production systems first if possible
Understand the changes being made to your system
The author is not responsible for any system damage, data loss, or unintended consequences resulting from the use of this tool. Use at your own risk.
Contributing
Contributions are welcome! Please:
Fork the repository
Create a feature branch (git checkout -b feature/improvement)
Commit your changes (git commit -m 'Add improvement')
Push to the branch (git push origin feature/improvement)
Open a Pull Request
License
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.
guettaf-hossam/superdiagnostictool
