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
| 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 |
| 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 |
Modern PyQt6 desktop interface with tabbed layout and professional styling
Comprehensive settings panel with theme customization and API configuration
Intelligent troubleshooting results with step-by-step solutions and confidence scoring
- 🎯 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
We love contributions! Win Sayver follows professional open-source development practices.
- Use our issue templates
- Include system information and error logs
- Provide clear steps to reproduce problems
- Check existing feature requests
- Use the feature request template
- Explain use cases and expected benefits
# 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