Skip to content

issu321/PhantomRange

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

8 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ”ฎ PHANTOM RANGE

NeuralCTF CyberArena X โ€” Adaptive AI-Powered Cybersecurity Training Simulator


๐ŸŒ Overview

PhantomRange is a futuristic, defensive-focused cybersecurity simulation platform built entirely in Python. It generates dynamic virtual infrastructures, simulates safe educational attack chains, and deploys an AI Defender that adapts in real time. Designed for training, CTF practice, and portfolio demonstration, it delivers a cyberpunk-hacker aesthetic with production-grade architecture.

Developer: issu321
Repository: github.com/issu321/PhantomRange


โœจ Features

  • ๐ŸŽฏ Adaptive Simulation Engine โ€” Randomized or scenario-based network generation
  • ๐Ÿค– AI Defender System โ€” scikit-learn powered threat detection with real-time countermeasures
  • ๐Ÿ•ธ๏ธ Interactive Network Graphs โ€” Plotly-powered topology visualization
  • โš”๏ธ Safe Attack Chain Simulation โ€” Educational reconnaissance โ†’ exfiltration pipeline
  • ๐Ÿ“Š Cyberpunk Dashboard โ€” Neon-themed metrics, risk heatmaps, and terminal streams
  • ๐Ÿ“ Exportable Reports โ€” JSON session dumps and CSV node inventories
  • ๐Ÿง  Explainable AI โ€” Feature importance and remediation recommendations

๐Ÿš€ Installation

Linux / macOS

git clone https://github.com/issu321/PhantomRange.git
cd PhantomRange
bash install.sh

Windows

git clone https://github.com/issu321/PhantomRange.git
cd PhantomRange
install.bat

The installer automatically creates a virtual environment, installs dependencies, and launches the Streamlit interface.


๐ŸŽฎ Usage

  1. Open the Dashboard from the sidebar
  2. Select a Scenario (or Random Generation) and Difficulty
  3. Click Initialize Simulation
  4. Navigate to Simulation Lab to execute attack phases
  5. Monitor the AI Defender responses and patch vulnerabilities in Network Graph
  6. Export reports from the Reports tab

๐Ÿงช Simulation Overview

Phase Description
Reconnaissance Simulated information gathering
Scanning Port and service enumeration
Credential Discovery Weak credential detection (educational)
Privilege Escalation Simulated access elevation
Lateral Movement Virtual network traversal
Data Exfiltration Sensitive data store discovery

All phases are sandboxed and simulated. No real exploitation occurs.


๐Ÿ› ๏ธ Technologies Used

  • Python 3.11+
  • Streamlit โ€” Frontend UI
  • Plotly โ€” Interactive visualizations
  • NetworkX โ€” Graph topology generation
  • scikit-learn โ€” AI defender RandomForest classifier
  • NumPy & Pandas โ€” Data processing
  • Matplotlib โ€” Static chart exports

๐Ÿ“ Folder Structure

PhantomRange/
โ”œโ”€โ”€ app.py                 # Main application (backend + frontend)
โ”œโ”€โ”€ requirements.txt       # Python dependencies
โ”œโ”€โ”€ README.md              # Project documentation
โ”œโ”€โ”€ install.sh             # Linux/macOS installer
โ”œโ”€โ”€ install.bat            # Windows installer
โ”œโ”€โ”€ inputguide.md          # Usage guide
โ”œโ”€โ”€ scenarios.json         # Predefined simulation scenarios
โ”œโ”€โ”€ .gitignore             # Git exclusions
โ””โ”€โ”€ assets/
    โ””โ”€โ”€ styles.css         # Cyberpunk Streamlit theme

๐Ÿง  AI Defender Explanation

The AI Defender uses a RandomForestClassifier trained on synthetic feature vectors representing:

  • Node security level
  • Vulnerability count
  • Historical alert frequency
  • Current attack phase index

When the simulation advances, the model predicts compromise probability per node. If risk exceeds the difficulty-adjusted threshold, the defender triggers actions such as virtual honeypot deployment, quarantine isolation, or authentication hardening.


โš ๏ธ Educational Disclaimer

PhantomRange is a SAFE educational simulation only.

  • No real malware is generated
  • No actual network exploitation occurs
  • All attack chains are abstracted and sandboxed
  • Intended for cybersecurity education, CTF training, and defensive skill development

๐Ÿ—บ๏ธ Future Roadmap

  • Plugin system for custom scenarios
  • Multiplayer CTF mode via WebSocket
  • LLM-powered narrative generation
  • MITRE ATT&CK framework mapping
  • Docker containerization

๐Ÿค Contribution Guide

  1. Fork the repository
  2. Create a feature branch (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

๐Ÿ“œ License

Distributed under the MIT License. See LICENSE for more information.


Developed by issu321

About

๐Ÿ”ฎ PHANTOM RANGE NeuralCTF CyberArena X โ€” Adaptive AI-Powered Cybersecurity Training Simulator

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors