Professional AI-powered Windows troubleshooting with Google Gemini 2.5 Pro
✨ Features • 🚀 Quick Start • 📖 Documentation • 🤝 Contributing • 💡 Examples
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.
- 🧠 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
- 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
- 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
- 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
- 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
- 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
- Windows 10 (build 1903+) or Windows 11
- Google Gemini API Key (Get free key)
- Download the latest
WinSayver.exefile from the 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 - 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
# 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-
🚀 Start the application
# Recommended: Use the pre-built executable from releases # Or run the batch file for source installation: run_win_sayver.bat
-
🔑 Configure API key
- Get your free API key from Google AI Studio
- Enter it in the secure API key dialog
- Your key is encrypted and stored locally with Fernet encryption
-
📊 Collect system specs
- Click "Collect System Specs" for comprehensive system analysis
- Review the detailed system information cards
-
🖼️ Add error screenshots
- Drag and drop error screenshots or use the file dialog
- Images are validated for security and format compatibility
-
🤖 Get AI-powered solutions
- Click "Start Analysis" for intelligent troubleshooting
- Receive step-by-step solutions with confidence scoring
# Win Sayver can analyze Blue Screen of Death errors
# Upload screenshot → Get detailed analysis → Follow step-by-step solutions# Drag & drop error dialog screenshot
# Receive targeted solutions for specific applications
# Get Windows Settings URLs for direct configuration``python
---
## 🛠️ 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
<div align="center">
### 🏠 Main Application Interface
*Modern PyQt6 desktop interface with tabbed layout and professional styling*
### ⚙️ Settings & Configuration
*Comprehensive settings panel with theme customization and API configuration*
### 🤖 AI Analysis Results
*Intelligent troubleshooting results with step-by-step solutions and confidence scoring*
</div>
---
## 🏆 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
- Follow Win Sayver Coding Standards
- Use type hints and comprehensive docstrings
- Maintain 85%+ test coverage
- Follow PEP 8 with 120-character line limit
This project is licensed under the MIT License - see the LICENSE file for details.
- 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! ⭐
Made with ❤️ for the Windows community
Professional AI-powered troubleshooting for everyone