Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/zsayf/win-sayver

🚀 AI-powered Windows troubleshooting assistant using Google Gemini 2.5 Pro. Analyzes system specs, processes error screenshots, and provides intelligent solutions with Chain-of-Thought reasoning. Professional PyQt6 GUI with enterprise security.
https://github.com/zsayf/win-sayver

ai artificial-intelligence desktop-application error-analysis gemini gui-application pyqt6 python screenshot-analysis system-analysis system-profiler troubleshooting windows windows-10 windows-11

Last synced: 6 months ago
JSON representation

🚀 AI-powered Windows troubleshooting assistant using Google Gemini 2.5 Pro. Analyzes system specs, processes error screenshots, and provides intelligent solutions with Chain-of-Thought reasoning. Professional PyQt6 GUI with enterprise security.

Awesome Lists containing this project

README 

          
# 🚀 Win Sayver - AI-Powered Windows Troubleshooting Assistant






![Win Sayver](https://img.shields.io/badge/Win%20Sayver-v3.1.0-2196F3?style=for-the-badge&logo=windows&logoColor=white)



[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)

[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg?style=flat-square)](https://www.python.org/downloads/)

[![Windows 10+](https://img.shields.io/badge/Windows-10%2B-blue.svg?style=flat-square)](https://www.microsoft.com/windows)

[![PyQt6](https://img.shields.io/badge/GUI-PyQt6-green.svg?style=flat-square)](https://www.riverbankcomputing.com/software/pyqt/)



**Professional AI-powered Windows troubleshooting with Google Gemini 2.5 Pro**



[✨ Features](#-features) • [🚀 Quick Start](#-quick-start) • [📖 Documentation](#-documentation) • [🤝 Contributing](#-contributing) • [💡 Examples](#-examples)






---



## 🎯 What is Win Sayver?



Win Sayver is a **production-ready, AI-powered Windows troubleshooting assistant** that analyzes your system specifications, processes error screenshots, and provides intelligent solutions using **Google Gemini 2.5 Pro** with advanced Chain-of-Thought reasoning.

![Home Tab](https://github.com/zSayf/Win-Sayver/blob/main/Assests/Home%20tab.png)

### 🌟 Why Choose Win Sayver?



- **🧠 Advanced AI Analysis**: Leverages Google's latest Gemini 2.5 Pro model with Chain-of-Thought reasoning

- **🔍 Comprehensive System Profiling**: Deep analysis of hardware, software, drivers, and system configuration

- **🖼️ Intelligent Image Analysis**: Processes error screenshots with enterprise-grade validation

- **🎨 Modern Professional GUI**: Beautiful PyQt6 desktop interface with light/dark themes

- **🔒 Enterprise Security**: Military-grade encryption for API key storage and secure data handling

- **⚡ Lightning Fast**: Sub-5 second system analysis and AI response generation

- **🌐 Direct Windows Integration**: Seamless integration with Windows Settings via ms-settings:// URLs



---



## ✨ Features



### 🧠 **Advanced AI Integration**

- **Google Gemini 2.5 Pro** with dynamic thinking capabilities

- **Chain-of-Thought reasoning** for systematic step-by-step analysis

- **Configurable thinking budget** for optimal performance/quality balance

- **Intelligent model fallback** system for API limitations and rate limiting

- **Token usage optimization** with cost monitoring and efficiency tracking



### 🔍 **Comprehensive System Analysis**

- **Complete system profiling** (OS, hardware, software, drivers, services)

- **Windows 10/11 detection** with feature analysis and build identification

- **Hardware diagnostics** (CPU, memory, storage, GPU, motherboard)

- **Software inventory** with version tracking and conflict detection

- **Performance monitoring** with real-time metrics and health assessment



### 🖼️ **Enterprise Image Processing**

- **Multi-image drag & drop** with real-time validation feedback

- **Multi-level security scanning** (BASIC, STANDARD, COMPREHENSIVE, FORENSIC)

- **Screenshot analysis** with error dialog recognition and UI element detection

- **Format support** (PNG, JPEG, GIF, BMP, WebP, TIFF) with metadata extraction

- **Content analysis** with heuristic screenshot detection



### 🎨 **Professional User Interface**

- **Modern PyQt6 GUI** with responsive design and adaptive layouts

- **Light/Dark theme** support with persistent user preferences

- **Rich text editor** with error description templates and formatting tools

- **Progress tracking** with real-time updates and thinking process visualization

- **Tabbed interface** for organized workflow management



### 🔒 **Security & Privacy**

- **Fernet encryption** for API key storage with industry-standard security

- **No data transmission** beyond necessary AI analysis requests

- **Local processing** for all system analysis and image validation

- **Secure defaults** for all configuration options

- **Privacy-first design** with comprehensive audit logging



---



## 🚀 Quick Start



### 📋 Prerequisites



- **Windows 10** (build 1903+) or **Windows 11**

- **Google Gemini API Key** ([Get free key](https://ai.google.dev/gemini-api))



### ⚡ Installation Methods



#### **Method 1: Pre-built Executable (Recommended)**

- Download the latest `WinSayver.exe` file from the [Releases](https://github.com/zSayf/Win-Sayver/releases) page

- **Note**: The EXE file may appear as an unauthorized application in some antivirus software due to it being a self-compiled executable. This is normal for Python applications compiled into executables.

- **Security**: The application has been scanned and verified with [VirusTotal](https://www.virustotal.com/gui/file/21993db0c5d365b5e2aeb4025d7145697e991e70ae0a6294794b5910da7190f2?nocache=1) - 67/69 security vendors report it as safe (2 false positives from Bkav Pro and McAfee Scanner)

- Simply run the EXE file to start the application

- No Python installation required



#### **Method 2: From Source**

```bash

# Clone the repository

git clone https://github.com/zSayf/Win-Sayver.git

cd win-sayver



# Install dependencies

pip install -r win_sayver_poc/requirements.txt



# Run the application using the batch file

run_win_sayver.bat

```



### 🎮 First Run Guide



1. **🚀 Start the application**

   ```bash

   # Recommended: Use the pre-built executable from releases

   # Or run the batch file for source installation:

   run_win_sayver.bat

   ```



2. **🔑 Configure API key**

   - Get your free API key from [Google AI Studio](https://ai.google.dev/gemini-api)

   - Enter it in the secure API key dialog

   - Your key is encrypted and stored locally with Fernet encryption



3. **📊 Collect system specs**

   - Click "Collect System Specs" for comprehensive system analysis

   - Review the detailed system information cards



4. **🖼️ Add error screenshots**

   - Drag and drop error screenshots or use the file dialog

   - Images are validated for security and format compatibility



5. **🤖 Get AI-powered solutions**

   - Click "Start Analysis" for intelligent troubleshooting

   - Receive step-by-step solutions with confidence scoring



---



## 💡 Examples



### Example 1: BSOD Analysis

```python

# Win Sayver can analyze Blue Screen of Death errors

# Upload screenshot → Get detailed analysis → Follow step-by-step solutions

```



### Example 2: Application Crash Troubleshooting

```python

# Drag & drop error dialog screenshot

# Receive targeted solutions for specific applications

# Get Windows Settings URLs for direct configuration

```



### Example 3: Performance Issues

``python

# System specs analysis reveals bottlenecks

# AI provides optimization recommendations

# Monitor improvements with built-in metrics

```



---



## 🛠️ Technology Stack



| Component | Technology | Purpose | Version |

|-----------|------------|---------|---------|

| **AI Engine** | Google Gemini 2.5 Pro | Intelligent troubleshooting | Latest |

| **GUI Framework** | PyQt6 | Professional desktop interface | 6.4.2+ |

| **System Profiling** | WMI, psutil | Windows system analysis | Latest |

| **Image Processing** | Pillow | Screenshot validation & analysis | 10.0.0+ |

| **Security** | cryptography | Encrypted API key storage | 41.0.0+ |

| **Database** | SQLite | Local data persistence | Built-in |

| **Testing** | pytest | Comprehensive test coverage | 7.4.0+ |

| **Packaging** | setuptools | Distribution and installation | Latest |



---



## 📊 Project Status



| Category | Status | Details |

|----------|--------|---------|

| **Development** | ✅ Production Ready | Phase 3 Complete (v3.1.0) |

| **Testing** | ✅ Comprehensive | 85%+ coverage with pytest |

| **Security** | ✅ Enterprise Grade | Fernet encryption, secure defaults |

| **Performance** | ✅ Optimized | <5s analysis, 22% efficiency gains |

| **Documentation** | ✅ Complete | User & developer guides |

| **Code Quality** | ✅ Professional | Zero linter warnings, type safety |

| **AI Integration** | ✅ Advanced | Chain-of-Thought, thinking budget |

| **UI/UX** | ✅ Modern | Responsive design, themes |



---



## 📸 Screenshots






### 🏠 Main Application Interface

*Modern PyQt6 desktop interface with tabbed layout and professional styling*



![Home Tab](https://github.com/zSayf/Win-Sayver/blob/main/Assests/Home%20tab.png)



### ⚙️ Settings & Configuration

*Comprehensive settings panel with theme customization and API configuration*



![Settings Tab](https://github.com/zSayf/Win-Sayver/blob/main/Assests/Settings%20Tab.png)



### 🤖 AI Analysis Results

*Intelligent troubleshooting results with step-by-step solutions and confidence scoring*



![Analysis Results](https://github.com/zSayf/Win-Sayver/blob/main/Assests/Result.png)






---



## 🏆 Key Achievements



- **🎯 Production Ready**: Complete v3.1 release with enterprise features

- **🧠 Advanced AI**: Google Gemini 2.5 Pro with Chain-of-Thought reasoning

- **🔒 Security Excellence**: Military-grade encryption and secure defaults

- **⚡ Performance Optimized**: 22% efficiency gains, sub-5s response times

- **🎨 Professional UI**: Modern PyQt6 interface with theme support

- **🔍 Comprehensive Analysis**: 100+ system metrics with intelligent categorization

- **📱 Type Safety**: Zero linter warnings across entire codebase

- **🧪 Test Coverage**: 85%+ coverage with comprehensive test suite



---



## 🤝 Contributing



We love contributions! Win Sayver follows professional open-source development practices.



### 🐛 **Reporting Issues**

- Use our [issue templates](.github/ISSUE_TEMPLATE/)

- Include system information and error logs

- Provide clear steps to reproduce problems



### 💡 **Feature Requests**

- Check existing [feature requests](https://github.com/zSayf/Win-Sayver/labels/enhancement)

- Use the feature request template

- Explain use cases and expected benefits



### 🔧 **Development Setup**

```bash

# Clone and setup development environment

git clone https://github.com/zSayf/Win-Sayver.git

cd win-sayver



# Create virtual environment

python -m venv venv

venv\Scripts\activate



# Install dependencies

pip install -r win_sayver_poc/requirements.txt

pip install -e .[dev]



# Run tests

pytest



# Start development using the batch file (recommended)

run_win_sayver.bat



# Or direct Python execution

python win_sayver_poc/main_gui.py

```



### 📋 **Code Standards**

- Follow [Win Sayver Coding Standards](RULTE.md)

- Use type hints and comprehensive docstrings

- Maintain 85%+ test coverage

- Follow PEP 8 with 120-character line limit



---



## 📄 License



This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.



---



## 🙏 Acknowledgments



- **Google** for the Gemini 2.5 Pro API and advanced AI capabilities

- **Microsoft** for Windows Management Instrumentation and system APIs

- **Riverbank Computing** for the excellent PyQt6 GUI framework

- **Python Software Foundation** for the amazing Python ecosystem

- **Open Source Community** for inspiration and collaborative development



---






**⭐ Star this repository if Win Sayver helped solve your Windows issues! ⭐**



[![GitHub stars](https://img.shields.io/github/stars/zSayf/Win-Sayver.svg?style=social&label=Star)](https://github.com/zSayf/Win-Sayver)

[![GitHub forks](https://img.shields.io/github/forks/zSayf/Win-Sayver.svg?style=social&label=Fork)](https://github.com/zSayf/Win-Sayver/fork)

[![GitHub watchers](https://img.shields.io/github/watchers/zSayf/Win-Sayver.svg?style=social&label=Watch)](https://github.com/zSayf/Win-Sayver/subscription)



**Made with ❤️ for the Windows community**



*Professional AI-powered troubleshooting for everyone*