ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β β
β ββββββββββββββββββββ ββββββ βββββββ ββββββ βββ βββ β
β ββββββββββββββββββββ βββββββββββββββββββββββββ βββ β
β ββββββ βββ ββββββββββββββ βββββββββββ βββ β
β ββββββ βββ ββββββββββββββ βββββββββββ βββ β
β ββββββββ βββ βββ βββββββββββββββββ ββββββββββββββ β
β ββββββββ βββ βββ ββββββ ββββββββββ ββββββββββββββ β
β β
β HACKING . PYTHON . SECURITY . INTELLIGENCE β
β β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Developed by issu321
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.
- 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)
- 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
- 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
- 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
- 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
- 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
- SAFE simulated vulnerability detection
- CVSS-style scoring and severity classification
- Risk heatmaps and defensive recommendations
- Based on open port scan results
- Protocol distribution charts
- Traffic statistics and bandwidth visualization
- Network interface monitoring
- Active connection tables
- Graceful fallback to simulated data when permissions are limited
- Attack chain (Cyber Kill Chain) visualization
- Threat radar charts and heatmaps
- Simulated threat trend analysis
- 24-hour threat activity timeline
- Real-time CPU, RAM, and disk usage
- Top processes by CPU/memory
- Network I/O counters
- System uptime and user sessions
- Upload TXT, CSV, JSON, LOG, PCAP files
- Automatic parsing and visualization
- Export reports in CSV, JSON, TXT formats
- Bulk export all reports
- 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
- Cross-domain correlation analysis
- Contextual security recommendations
- Compound risk assessment
- Platform health summary
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β 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
- Python 3.11+ (3.12 recommended)
- pip package manager
- Git (for cloning)
# Clone the repository
git clone https://github.com/issu321/Ethical-Hacking-Python.git
cd Ethical-Hacking-Python
# Run the automated installer
bash install.shThe installer will:
- β Check Python version
- β
Create a virtual environment (
venv/) - β
Install all dependencies from
requirements.txt - β Launch Streamlit automatically
Manual installation:
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
streamlit run app.pySystem dependencies (if scapy fails):
sudo apt-get update
sudo apt-get install -y libpcap-dev# Clone the repository
git clone https://github.com/issu321/Ethical-Hacking-Python.git
cd Ethical-Hacking-Python
# Run the automated installer
.\install.batManual installation:
python -m venv venv
.οΏ½env\ScriptsοΏ½ctivate
pip install -r requirements.txt
streamlit run app.pyNote 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
When you launch the application, you'll experience:
- π¬ Boot Sequence β Animated terminal-style boot with module loading
- π Main Dashboard β Live metrics, threat radar, attack chain, system gauges
- π§ Sidebar Navigation β 18 modules accessible from the cyberpunk sidebar
- π΄ Live SOC Feed β Simulated security operations center alerts
- π¨ Cyberpunk Theme β Dark interface with neon cyan/green/pink accents
| 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 |
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
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
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
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
Performs static analysis on uploaded files:
- Magic bytes identification
- MIME type guessing
- Entropy analysis (packed/encrypted detection)
- Dangerous extension warnings
- Comprehensive hash generation
SAFE simulation engine that maps open ports to known vulnerability patterns:
- Simulated CVSS scoring
- Severity classification (Critical/High/Medium/Low)
- Defensive recommendations
- Risk heatmaps
- Navigate to π Upload Center
- Drag and drop or select files (TXT, CSV, JSON, LOG, PCAP)
- Files are automatically parsed:
- CSV β DataFrame + auto bar charts
- JSON β Structured tree view
- TXT/LOG β Terminal-style display
- Upload history is tracked in session
- Navigate to π₯ Download Center
- View all generated reports with timestamps
- Export individual reports as:
- π JSON β Full structured data
- π CSV β Tabular data export
- π TXT β Formatted security report
- Use Bulk Export to download all reports as a single JSON file
| 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.
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
| 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 |
- 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
We welcome contributions from the cybersecurity community!
- Fork the repository
- Create a branch for your feature (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- 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.mdandinputguide.mdfor new features - Ensure cross-platform compatibility (Linux & Windows)
- Use GitHub Issues for bug reports
- Include Python version, OS, and error traceback
- Describe steps to reproduce
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.
Developed by issu321
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β STAY ETHICAL. STAY CURIOUS. STAY SECURE. β
β β
β Ethical Hacking & Security Intelligence Platform β
β Developed by issu321 β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Star this repo if you find it useful! β