Unified, Semi-Automated Penetration Testing & Vulnerability Assessment Platform
TORNET integrates industry-standard offensive security tools into a cohesive, high-performance command center dashboard with real-time WebSocket telemetry, adaptive reconnaissance pipelines, and automated reporting.
Caution
DISCLAIMER & ETHICAL USE POLICY
TORNET is designed strictly for authorized penetration testing, vulnerability assessments, and educational research conducted with explicit permission from system owners. Unauthorized access to computer systems or networks is illegal under international cyber law. The authors and contributors assume no liability for misuse.
- Key Features
- Architecture
- Integrated Security Toolset
- Prerequisites
- Quick Start
- OPSEC & Anonymization Engine
- Plugin System
- Documentation
- License
- 🖥️ Dark Mode Command Center — Professional SOC/Red Team dashboard with live resource telemetry, target profiling, and scan visualizers.
- ⚡ One-Click Automated Scans — Configure target and scan profile (
Light,Medium,Aggressive) to trigger automated multi-stage reconnaissance and vulnerability discovery. - 🔄 Live WebSocket Terminal — Real-time bidirectional streaming of tool outputs directly to an interactive in-browser terminal (
xterm.js). - 🛡️ OPSEC Shield — Integrated anonymization engine with Tor traffic routing, automatic MAC address rotation, and VPN profile management.
- 📊 Comprehensive Reporting — Automated risk scoring (CVSS/Severity), remediation guidance, and exportable reports in PDF, HTML, and JSON.
- 🔌 Dynamic Plugin Engine — Add new CLI tools, custom scanners, or API fuzzers on the fly without modifying core codebase.
- 🔐 Zero-Configuration Persistence — Local SQLite database with encrypted authentication, session management, and scheduling.
flowchart TD
subgraph UI ["Frontend (React 18 + Vite)"]
DASH["Dashboard & Target Manager"]
TERM["Live WebSocket Terminal (xterm.js)"]
REPORTS["Reports & Vulnerability Matrix"]
end
subgraph API ["Backend (FastAPI + ASGI)"]
AUTH["JWT Authentication"]
WS["WebSocket Manager"]
ORCH["Tool Orchestration Engine"]
ADAPT["Adaptive Scanner & Profiler"]
OPSEC["OPSEC & Privacy Manager"]
DB[(SQLite / tornet.db)]
end
subgraph ENGINE ["Security Tool Layer (WSL2 / Kali / Native)"]
NMAP["Nmap / Port Scan"]
NUCLEI["Nuclei CVE Engine"]
SQLMAP["SQLMap API"]
NIKTO["Nikto Web Scan"]
GOBUSTER["Gobuster / Feroxbuster"]
SUBFINDER["Subfinder & Amass"]
WHATWEB["WhatWeb & HTTPX"]
end
UI <-->|REST API + WebSocket| API
API -->|Async Subprocess / API| ENGINE
| Category | Tools Integrated | Role |
|---|---|---|
| Reconnaissance | Nmap, Subfinder, Amass, WhatWeb, HTTPX |
Asset discovery, open ports, service fingerprinting, technology stack |
| Vulnerability Scanning | Nuclei, Nikto, OWASP ZAP |
Automated CVE verification, misconfigurations, web application flaws |
| Exploitation & Injection | SQLMap, XSStrike, Metasploit RPC |
SQL injection detection, XSS proof-of-concept, exploitation verification |
| Content Discovery | Gobuster, Feroxbuster, FFUF |
High-speed directory brute-forcing, sensitive endpoints, hidden assets |
| OPSEC & Network | Tor, OpenVPN, Macchanger, Scapy |
Traffic routing, source anonymity, active packet crafting |
- Operating System: Windows 10/11 (with WSL2 enabled) or Linux (Ubuntu 22.04+ / Debian / Kali)
- Python: 3.11+
- Node.js: 18+ LTS
- Package Managers:
pipandnpm - (Optional) Docker Desktop & Docker Compose
git clone https://github.com/robinandreoni/TorNet.git
cd TorNetcp .env.example .envcd backend
python -m venv venv
# On Windows:
venv\Scripts\activate
# On Linux / macOS:
source venv/bin/activate
pip install -r requirements.txtcd ../frontend
npm installFrom the project root:
- Batch Launcher: Double-click or run
start_tornet.bat - PowerShell Launcher: Run
powershell -ExecutionPolicy Bypass -File start_tornet.ps1
Both scripts will start the backend (http://127.0.0.1:8000), launch the frontend (http://127.0.0.1:5173), and open your browser automatically.
For a containerized setup:
cd docker
docker compose up -dAccess the dashboard at http://localhost:3000 and the API documentation at http://localhost:8000/docs.
TORNET includes an integrated OPSEC shield designed to ensure operator privacy during security research:
- Tor Circuit Routing: Route command traffic through the Tor onion network.
- Public VPN Integration: Automated fetching and configuration of dynamic OpenVPN profiles.
- Interface Anonymization: Automated MAC address randomization via
macchanger. - Stealth Score: Real-time score evaluating active DNS leaks, public IP exposure, and connection security.
Adding a new tool is as simple as creating a JSON manifest in backend/plugins/:
{
"id": "custom_scanner",
"name": "custom_scanner",
"display_name": "My Custom Scanner",
"category": "Vulnerability Scanning",
"command_template": "tool-binary -u {target} {intensity_flags}",
"enabled": true
}Detailed documentation is available in the docs/ directory:
This project is licensed under the MIT License — see the LICENSE file for details.