feat: Initial release - CyberGuardian-X complete threat intelligence suite

Author: APMarzuki

.gitignore

@@ -0,0 +1,65 @@
+# .gitignore
+
+# API Keys and Configuration
+config.ini
+keys.example.ini
+*.key
+*.env
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+dist/
+build/
+
+# Virtual Environment
+.venv/
+venv/
+ENV/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Logs
+logs/
+*.log
+
+# Database
+*.db
+*.sqlite
+*.sqlite3
+
+# Quarantine
+quarantine/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Temporary files
+*.tmp
+*.temp

CONTRIBUTING.md

@@ -0,0 +1,113 @@
+# Contributing to CyberGuardian-X
+
+We love your input! We want to make contributing to CyberGuardian-X as easy and transparent as possible.
+
+## Development Setup
+
+1. Fork the repo and create your branch from `main`
+2. Set up the development environment:
+   ```bash
+   git clone https://github.com/your-username/CyberGuardian-X.git
+   cd CyberGuardian-X
+   python -m venv .venv
+   .venv\Scripts\activate  # Windows
+   pip install -r requirements.txt
+   
+Pull Request Process
+Ensure any install or build dependencies are removed before the end of the layer
+
+Update the README.md with details of changes to the interface
+
+Increase the version numbers in any examples and the README.md
+
+Your PR will be merged once you have the sign-off of other developers
+
+Code Style
+Follow PEP 8 for Python code
+
+Use descriptive variable names
+
+Add comments for complex logic
+
+Include type hints where possible
+
+Security
+Never commit API keys or sensitive data
+
+Use keys.example.ini for configuration templates
+
+Report security vulnerabilities privately
+
+text
+
+### **6. Create GitHub Release Preparation Script**
+```python
+# prepare_release.py
+import os
+import shutil
+import datetime
+
+def prepare_release():
+    """Prepare files for GitHub release"""
+    print("🚀 Preparing CyberGuardian-X Release...")
+    
+    # Create release directory
+    release_dir = "release"
+    if os.path.exists(release_dir):
+        shutil.rmtree(release_dir)
+    os.makedirs(release_dir)
+    
+    # Copy executable
+    exe_source = "dist/CyberGuardian-X.exe"
+    if os.path.exists(exe_source):
+        shutil.copy2(exe_source, release_dir)
+        print(f"✅ Copied executable: {exe_source}")
+    else:
+        print("❌ Executable not found. Build it first with: pyinstaller")
+    
+    # Copy key files
+    files_to_copy = [
+        "README.md",
+        "LICENSE",
+        "requirements.txt",
+        "keys.example.ini",
+        "config.ini.example"  # We'll create this
+    ]
+    
+    for file in files_to_copy:
+        if os.path.exists(file):
+            shutil.copy2(file, release_dir)
+            print(f"✅ Copied: {file}")
+    
+    # Create example config without real keys
+    with open("release/config.ini.example", "w") as f:
+        f.write("""[API_KEYS]
+VIRUSTOTAL_API_KEY = your_virustotal_key_here
+OTX_API_KEY = your_otx_key_here
+ABUSEIPDB_API_KEY = your_abuseipdb_key_here
+SHODAN_API_KEY = your_shodan_key_here
+URLSCAN_API_KEY = your_urlscan_key_here
+HYBRIDANALYSIS_API_KEY = your_hybrid_analysis_key_here
+METADEFENDER_API_KEY = your_metadefender_key_here
+
+[APP]
+CACHE_FILE = data/cache.json
+DB_FILE = data/cgx.db
+LOG_DIR = logs
+QUARANTINE_DIR = quarantine
+TIMEOUT = 30
+MAX_FILE_SIZE = 100
+USE_PROXY = false
+
+[MONITORING]
+ENABLED = false
+WATCH_DIRS = Downloads,Desktop
+AUTO_QUARANTINE = true
+SCORE_THRESHOLD = 70
+""")
+    
+    print(f"\n🎉 Release files prepared in: {release_dir}/")
+    print("📦 Ready to upload to GitHub Releases!")
+
+if __name__ == "__main__":
+    prepare_release()

CyberGuardian-X.spec

@@ -0,0 +1,38 @@
+# -*- mode: python ; coding: utf-8 -*-
+
+
+a = Analysis(
+    ['app.py'],
+    pathex=[],
+    binaries=[],
+    datas=[],
+    hiddenimports=[],
+    hookspath=[],
+    hooksconfig={},
+    runtime_hooks=[],
+    excludes=[],
+    noarchive=False,
+    optimize=0,
+)
+pyz = PYZ(a.pure)
+
+exe = EXE(
+    pyz,
+    a.scripts,
+    a.binaries,
+    a.datas,
+    [],
+    name='CyberGuardian-X',
+    debug=False,
+    bootloader_ignore_signals=False,
+    strip=False,
+    upx=True,
+    upx_exclude=[],
+    runtime_tmpdir=None,
+    console=False,
+    disable_windowed_traceback=False,
+    argv_emulation=False,
+    target_arch=None,
+    codesign_identity=None,
+    entitlements_file=None,
+)

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 APMarzuki
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.