Skip to content

About

AI Cybersecurity Operations Center + Ethical Hacking Toolkit + Threat Intelligence Platform

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

╔══════════════════════════════════════════════════════════════════════╗
β•‘                                                                      β•‘
β•‘     β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ•—  β–ˆβ–ˆβ•—β–ˆβ–ˆβ•— β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ•—     β–ˆβ–ˆβ•—          β•‘
β•‘     β–ˆβ–ˆβ•”β•β•β•β•β•β•šβ•β•β–ˆβ–ˆβ•”β•β•β•β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•”β•β•β•β•β•β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—β–ˆβ–ˆβ•‘     β–ˆβ–ˆβ•‘          β•‘
β•‘     β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—     β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘     β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘     β–ˆβ–ˆβ•‘          β•‘
β•‘     β–ˆβ–ˆβ•”β•β•β•     β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘     β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘     β–ˆβ–ˆβ•‘          β•‘
β•‘     β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—   β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘β•šβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•‘β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ•‘          β•‘
β•‘     β•šβ•β•β•β•β•β•β•   β•šβ•β•   β•šβ•β•  β•šβ•β•β•šβ•β• β•šβ•β•β•β•β•β•β•šβ•β•  β•šβ•β•β•šβ•β•β•β•β•β•β•β•šβ•β•          β•‘
β•‘                                                                      β•‘
β•‘              HACKING  .  PYTHON  .  SECURITY  .  INTELLIGENCE         β•‘
β•‘                                                                      β•‘
β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•

πŸ›‘οΈ Ethical Hacking Python

AI Cybersecurity Operations Center + Ethical Hacking Toolkit + Threat Intelligence Platform

Developed by issu321


🌐 Overview

Ethical Hacking Python is a next-generation cybersecurity intelligence platform designed for educational, defensive, and ethical hacking purposes. Built as a futuristic cyberpunk SOC dashboard, it combines:

  • πŸ€– AI-inspired security analysis with contextual insights
  • πŸ” Advanced network scanning with topology visualization
  • 🌐 OSINT domain intelligence (WHOIS, DNS, SSL, subdomains)
  • πŸ” Password strength analysis with entropy scoring
  • πŸ§ͺ Cryptographic hashing laboratory (MD5, SHA family, BLAKE2)
  • πŸ“ File security analyzer with upload/download systems
  • ⚠️ Vulnerability assessment simulation with CVSS scoring
  • πŸ“Š Packet analytics and system monitoring
  • 🧠 Cyber threat intelligence with visualizations
  • πŸ“ˆ Advanced analytics engine (radar, heatmaps, node graphs)

⚑ Mission: Empower cybersecurity students, professionals, and enthusiasts with a safe, visual, and interactive defensive toolkit.


✨ Features

1. πŸ€– AI Cybersecurity Dashboard

  • Live cyber metrics and risk levels
  • Animated widgets and fake SOC operations feed
  • Cyber activity stream with real-time terminal simulation
  • System telemetry gauges (CPU, RAM, Disk)

2. πŸ” Advanced Network Scanner

  • TCP connect-based port scanning (safe & educational)
  • Custom IP and localhost scanning
  • Open port detection with service identification
  • Latency analysis and protocol classification
  • Network topology visualization with node graphs
  • Port heatmaps and risk scoring

3. 🌐 Domain & Subdomain Intelligence

  • WHOIS lookup with domain age analysis
  • Multi-record DNS resolution (A, AAAA, MX, NS, TXT, SOA, CNAME)
  • SSL certificate inspection and expiry monitoring
  • Subdomain enumeration with DNS resolution
  • Domain reputation simulation for threat visualization
  • Relationship maps and DNS charts

4. πŸ” Password Strength AI Analyzer

  • Shannon entropy calculation
  • Complexity analysis (upper, lower, digits, special)
  • Pattern detection (dictionary, sequential, keyboard, dates)
  • Strength scoring (0-100) with visual gauges
  • AI-generated security recommendations

5. πŸ§ͺ Advanced Hashing Laboratory

  • Support for MD5, SHA1, SHA256, SHA512, SHA3-256, SHA3-512, BLAKE2b, BLAKE2s
  • Text and file hashing with drag-and-drop support
  • Integrity verification and hash comparison
  • One-click hash export

6. πŸ“ File Security Analyzer

  • Suspicious extension detection
  • Magic bytes and MIME type analysis
  • Entropy analysis for packed/encrypted detection
  • MD5/SHA1/SHA256 hash generation
  • Risk scoring with downloadable reports

7. ⚠️ Vulnerability Assessment Simulation

  • SAFE simulated vulnerability detection
  • CVSS-style scoring and severity classification
  • Risk heatmaps and defensive recommendations
  • Based on open port scan results

8. πŸ“Š Packet Analytics Visualization

  • Protocol distribution charts
  • Traffic statistics and bandwidth visualization
  • Network interface monitoring
  • Active connection tables
  • Graceful fallback to simulated data when permissions are limited

9. 🧠 Cyber Threat Intelligence

  • Attack chain (Cyber Kill Chain) visualization
  • Threat radar charts and heatmaps
  • Simulated threat trend analysis
  • 24-hour threat activity timeline

10. πŸ’» System Monitor

  • Real-time CPU, RAM, and disk usage
  • Top processes by CPU/memory
  • Network I/O counters
  • System uptime and user sessions

11. πŸ“‚ Upload & πŸ“₯ Download Systems

  • Upload TXT, CSV, JSON, LOG, PCAP files
  • Automatic parsing and visualization
  • Export reports in CSV, JSON, TXT formats
  • Bulk export all reports

12. 🎨 Cyber Visualization Engine

  • Animated Plotly charts with cyberpunk dark theme
  • NetworkX node graphs for topology
  • Radar charts, heatmaps, bar/pie/line charts
  • Risk gauges and system gauges
  • Glowing neon UI with terminal aesthetics

13. πŸ€– AI Security Insights

  • Cross-domain correlation analysis
  • Contextual security recommendations
  • Compound risk assessment
  • Platform health summary

πŸ›‘οΈ Ethical Hacking Disclaimer

╔════════════════════════════════════════════════════════════════╗
β•‘  THIS PROJECT IS STRICTLY FOR EDUCATIONAL AND DEFENSIVE USE   β•‘
β•‘  ONLY.                                                         β•‘
β•‘                                                                β•‘
β•‘  β€’ Only scan systems you OWN or have WRITTEN AUTHORIZATION    β•‘
β•‘    to test.                                                    β•‘
β•‘  β€’ All tools are designed for AUTHORIZED LAB ENVIRONMENTS.    β•‘
β•‘  β€’ No malware, ransomware, or destructive payloads included.   β•‘
β•‘  β€’ No credential theft or illegal persistence mechanisms.       β•‘
β•‘  β€’ Use responsibly and in compliance with all applicable laws. β•‘
β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•

By using this software, you agree to:

  • Use it only on systems you own or have explicit permission to test
  • Follow responsible disclosure practices
  • Comply with local, national, and international cybersecurity laws
  • Use it for learning, teaching, and defensive hardening only

πŸš€ Installation

Prerequisites

  • Python 3.11+ (3.12 recommended)
  • pip package manager
  • Git (for cloning)

Linux / Kali Linux / Ubuntu / Debian

# Clone the repository
git clone https://github.com/issu321/Ethical-Hacking-Python.git
cd Ethical-Hacking-Python

# Run the automated installer
bash install.sh

The installer will:

  1. βœ… Check Python version
  2. βœ… Create a virtual environment (venv/)
  3. βœ… Install all dependencies from requirements.txt
  4. βœ… Launch Streamlit automatically

Manual installation:

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
streamlit run app.py

System dependencies (if scapy fails):

sudo apt-get update
sudo apt-get install -y libpcap-dev

Windows 10 / 11

# Clone the repository
git clone https://github.com/issu321/Ethical-Hacking-Python.git
cd Ethical-Hacking-Python

# Run the automated installer
.\install.bat

Manual installation:

python -m venv venv
.οΏ½env\ScriptsοΏ½ctivate
pip install -r requirements.txt
streamlit run app.py

Note for Windows:

  • Install Npcap for full packet capture features
  • Run as Administrator for raw socket operations
  • The app gracefully falls back to simulated data without admin rights

πŸ–₯️ Dashboard Overview

When you launch the application, you'll experience:

  1. 🎬 Boot Sequence β€” Animated terminal-style boot with module loading
  2. πŸ“Š Main Dashboard β€” Live metrics, threat radar, attack chain, system gauges
  3. 🧭 Sidebar Navigation β€” 18 modules accessible from the cyberpunk sidebar
  4. πŸ”΄ Live SOC Feed β€” Simulated security operations center alerts
  5. 🎨 Cyberpunk Theme β€” Dark interface with neon cyan/green/pink accents

Navigation Modules

Module Icon Description
Dashboard 🏠 Central command center with live metrics
Network Scanner πŸ” TCP port scanning with topology maps
Domain Intelligence 🌐 WHOIS, DNS, SSL analysis
Subdomain Intelligence πŸ“‘ Subdomain enumeration & graphs
Password Analyzer πŸ” Entropy & strength analysis
Hashing Laboratory πŸ§ͺ Multi-algorithm hashing lab
File Security Analyzer πŸ“ Upload & analyze file security
Vulnerability Intelligence ⚠️ Simulated vulnerability assessment
Packet Analytics πŸ“Š Network traffic visualization
Threat Intelligence 🧠 Attack chains & threat radars
System Monitor πŸ’» Real-time resource monitoring
Upload Center πŸ“‚ Import logs and data files
Download Center πŸ“₯ Export reports in multiple formats
Cyber Analytics πŸ“ˆ Custom chart generation engine
DNS Intelligence 🌍 Multi-record DNS lookups
Network Topology πŸ›°οΈ Interactive node graphs
Reports Center πŸ“‹ View and manage all reports
AI Security Insights πŸ€– Cross-domain AI analysis

πŸ› οΈ Tool Explanations

Advanced Network Scanner

Uses Python's socket library for safe TCP connect scanning. Multi-threaded for speed. Detects open ports, attempts safe banner grabbing, and classifies severity. Results are visualized as:

  • Interactive data tables
  • Port status heatmaps
  • Network topology node graphs
  • Risk score gauges

Domain Intelligence

Integrates python-whois, dnspython, and ssl modules to gather:

  • Registration details and domain age
  • DNS records across multiple types
  • SSL certificate validity and cipher info
  • Simulated reputation scoring for threat visualization

Password Analyzer

Implements Shannon entropy calculation and pattern recognition:

  • Checks against common password dictionaries
  • Detects sequential characters and keyboard patterns
  • Identifies date/year patterns
  • Provides AI-generated hardening recommendations

Hashing Laboratory

Supports 8 hash algorithms using Python's hashlib:

  • MD5, SHA1, SHA256, SHA512, SHA3-256, SHA3-512, BLAKE2b, BLAKE2s
  • Text and file input
  • Integrity verification with hash comparison

File Security Analyzer

Performs static analysis on uploaded files:

  • Magic bytes identification
  • MIME type guessing
  • Entropy analysis (packed/encrypted detection)
  • Dangerous extension warnings
  • Comprehensive hash generation

Vulnerability Assessment

SAFE simulation engine that maps open ports to known vulnerability patterns:

  • Simulated CVSS scoring
  • Severity classification (Critical/High/Medium/Low)
  • Defensive recommendations
  • Risk heatmaps

πŸ“€ Upload & Download Guide

Uploading Files

  1. Navigate to πŸ“‚ Upload Center
  2. Drag and drop or select files (TXT, CSV, JSON, LOG, PCAP)
  3. Files are automatically parsed:
    • CSV β†’ DataFrame + auto bar charts
    • JSON β†’ Structured tree view
    • TXT/LOG β†’ Terminal-style display
  4. Upload history is tracked in session

Downloading Reports

  1. Navigate to πŸ“₯ Download Center
  2. View all generated reports with timestamps
  3. Export individual reports as:
    • πŸ“„ JSON β€” Full structured data
    • πŸ“Š CSV β€” Tabular data export
    • πŸ“ TXT β€” Formatted security report
  4. Use Bulk Export to download all reports as a single JSON file

πŸ“Š Visualization Explanations

Visualization Purpose Data Source
Radar Charts Multi-axis security scoring Password, threat, domain data
Heatmaps Intensity mapping Port scans, threat timelines
Node Graphs Relationship mapping Network topology, subdomains
Gauges Risk/entropy scoring Scan results, password analysis
Pie/Donut Distribution analysis Protocols, threat categories
Bar Charts Comparative metrics DNS records, threat types
Line Charts Trend analysis 24h threat activity
Tables Detailed findings Vulnerabilities, processes

All visualizations use a cyberpunk dark theme with neon accents for immersive SOC aesthetics.


πŸ“ Folder Structure

Ethical-Hacking-Python/
β”‚
β”œβ”€β”€ app.py                    # Main Streamlit application (UI + routing)
β”œβ”€β”€ security_tools.py         # Scanners, password, hashing, file, vuln, packet, system
β”œβ”€β”€ analytics.py              # Charts, heatmaps, graphs, gauges, reporting
β”œβ”€β”€ osint_tools.py            # WHOIS, DNS, subdomains, IP intel, SSL, metadata
β”œβ”€β”€ utils.py                  # Helpers, exports, logging, SOC feed, AI insights
β”‚
β”œβ”€β”€ requirements.txt          # Python dependencies
β”œβ”€β”€ README.md               # This file
β”œβ”€β”€ inputguide.md           # Usage examples and troubleshooting
β”œβ”€β”€ install.sh              # Linux/Kali automated installer
β”œβ”€β”€ install.bat             # Windows automated installer
β”‚
β”œβ”€β”€ security_reports.csv    # Starter report database
β”œβ”€β”€ threat_logs.json        # Starter threat log database
β”œβ”€β”€ .gitignore              # Git ignore rules
β”‚
└── assets/
    β”œβ”€β”€ styles.css          # Cyberpunk CSS theme
    β”œβ”€β”€ banner.txt          # ASCII art banner
    └── animations.json     # Boot sequence & SOC alert configs

🧰 Technologies Used

Category Libraries
Frontend Streamlit
Visualization Plotly, NetworkX, Matplotlib (fallback)
Data Processing Pandas, NumPy
Cybersecurity Scapy, psutil, socket, whois, dnspython
Cryptography hashlib (built-in)
Networking requests, certifi
Utilities rich, asyncio, threading
Styling Custom CSS with Google Fonts

πŸ—ΊοΈ Future Roadmap

  • Real-time packet capture with Scapy integration (admin mode)
  • CVE database integration for live vulnerability lookup
  • Shodan API integration for internet-facing asset discovery
  • MITRE ATT&CK mapping for threat intelligence
  • PDF report generation with professional formatting
  • Multi-language support (internationalization)
  • Dark/Light theme toggle
  • User authentication and session management
  • API endpoint for programmatic access
  • Docker containerization for one-click deployment

🀝 Contribution Guide

We welcome contributions from the cybersecurity community!

How to Contribute

  1. Fork the repository
  2. Create a branch for your feature (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Guidelines

  • All contributions must remain educational and defensive
  • No malicious or destructive code will be accepted
  • Follow PEP 8 style guidelines
  • Add docstrings to all functions
  • Update README.md and inputguide.md for new features
  • Ensure cross-platform compatibility (Linux & Windows)

Reporting Issues

  • Use GitHub Issues for bug reports
  • Include Python version, OS, and error traceback
  • Describe steps to reproduce

πŸ“œ License

This project is licensed under the MIT License.

MIT License

Copyright (c) 2024 issu321

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.

πŸ‘€ Developer

Developed by issu321

GitHub Repository


╔══════════════════════════════════════════════════════════════════════╗
β•‘     STAY ETHICAL.  STAY CURIOUS.  STAY SECURE.                      β•‘
β•‘                                                                      β•‘
β•‘     Ethical Hacking & Security Intelligence Platform                  β•‘
β•‘     Developed by issu321                                            β•‘
β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•

⭐ Star this repo if you find it useful! ⭐

About

AI Cybersecurity Operations Center + Ethical Hacking Toolkit + Threat Intelligence Platform

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages