Add files via upload

Author: ProjectZeroDays

documentation/INSTALLATION_GUIDE.md

@@ -0,0 +1,145 @@
+
+# Installation Instructions for GUI with Backend Integration
+
+## 📁 Files Created
+
+1. **backend_adapters.py** - Adapter/wrapper classes for proper module initialization
+2. **gui.py** - Updated GUI that uses the adapters
+
+## 🚀 Installation Steps
+
+### Step 1: Copy Files to Your Project
+
+Copy both files to your `src/` directory:
+```
+C:\Users\Administrator\Desktop\zero-click-exploits\src\
+```
+
+### Step 2: Verify File Locations
+
+Your `src/` directory should now contain:
+```
+src/
+├── backend_adapters.py     <-- NEW
+├── gui.py                  <-- UPDATED
+├── exploit/
+│   └── exploit_module.py
+├── botnet/
+│   └── botnet_manager.py
+├── ai/
+│   └── ai_model.py
+├── device_control/
+│   └── device_manager.py
+├── monitoring/
+│   └── real_time_monitor.py
+├── post_exploitation/
+│   └── post_exploit.py
+├── encryption/
+│   └── polymorphic_encryptor.py
+├── networking/
+│   └── reverse_doh.py
+└── social/
+    ├── sms_spoofing.py
+    └── email_spoofing.py
+```
+
+### Step 3: Run the GUI
+
+```bash
+cd C:\Users\Administrator\Desktop\zero-click-exploits\src
+python gui.py
+```
+
+## ✅ What the Adapters Do
+
+The `backend_adapters.py` file provides:
+
+1. **ConfigManager** - Creates default configuration for all modules
+2. **GUILogger** - Logger that outputs to both console and GUI log panel
+3. **Module Adapters** - Wrapper classes that:
+   - Provide required `config` and `logger` arguments to your modules
+   - Handle missing methods gracefully
+   - Provide fallback implementations for demo mode
+
+## 🔧 How It Works
+
+### Before (Failed):
+```python
+ExploitManager()  # Missing required 'config' argument
+BotnetManager()   # Missing required 'logger' argument
+```
+
+### After (Works):
+```python
+ExploitAdapter(config, logger)  # Provides required arguments
+BotnetAdapter(config, logger)   # Provides required arguments
+```
+
+## 🎯 Expected Output
+
+When you run the GUI, you should see:
+```
+✓ Exploit adapter initialized
+✓ Botnet adapter initialized
+✓ AI adapter initialized
+✓ Device adapter initialized
+✓ Monitor adapter initialized
+✓ Encryptor adapter initialized
+✓ Tunnel adapter initialized
+✓ SMS adapter initialized
+✓ Email adapter initialized
+```
+
+And in the GUI log panel:
+```
+[SUCCESS] Framework initialized successfully
+[SUCCESS] Backend adapters loaded: 8 modules
+[DEBUG]   ✓ exploit
+[DEBUG]   ✓ botnet
+[DEBUG]   ✓ ai
+...
+[INFO] Zero-click exploit modules ready
+```
+
+## 🔍 Troubleshooting
+
+### If modules still fail to load:
+
+1. **Check your module classes exist:**
+   ```python
+   # In your exploit_module.py, you should have:
+   class ExploitManager:
+       def __init__(self, config):
+           ...
+   ```
+
+2. **Check required arguments:**
+   The adapters expect these signatures:
+   - `ExploitManager(config)`
+   - `BotnetManager(config, logger)`
+   - `AIPredictor(config)`
+   - etc.
+
+3. **Check import paths:**
+   The adapters try multiple import paths:
+   - `src.exploit.exploit_module`
+   - `exploit.exploit_module`
+   - `exploit_module`
+
+### To customize adapter behavior:
+
+Edit `backend_adapters.py` and modify the adapter classes to match your exact module signatures.
+
+## 📊 Features Now Available
+
+With the adapters in place, the GUI can now:
+- ✅ Deploy exploits through your ExploitManager
+- ✅ Manage bots through your BotnetManager
+- ✅ Run AI analysis through your AIPredictor
+- ✅ Control devices through your DeviceManager
+- ✅ Monitor operations through your RealTimeMonitor
+- ✅ Generate encrypted payloads through your PolymorphicEncryptor
+- ✅ Manage DoH tunnels through your ReverseDoHTunnel
+- ✅ Send spoofed messages through your SMSSpoofer/EmailSpoofer
+
+All with proper error handling and fallback to demo mode if modules are unavailable!