Repository files navigation

nvs-core is the backend engine of theNVS (Network Vulnerability Scanner) project. It contains CLI scripts and scanning logic to detect device services, open ports, and potential WiFi vulnerabilities. Designed to be used standalone or through thenvs-web interface.

• 🔍 Scan for active WiFi networks
• 🧪 Check for open ports and known vulnerabilities
• ⚙️ Perform device service fingerprinting
• 📡 Prepare data for web visualization via API (used bynvs-web)

• Python 3.8+
• nmap installed
• Linux or Unix-like system (recommended)
• (Optional) Flask for API mode

git clone https://github.com/undertry/nvs-core.gitcd nvs-core

python3 -m venv venvsource venv/bin/activate

pip install -r requirements.txt

python3 scanner.py

Or use specific tools:

bash scripts/scan_wifi.shbash scripts/scan_ports.sh

python3 api_server.py

The API will be available athttp://localhost:5000.

nvs-core/├── scripts/           → Shell scripts for network scanning├── scanner.py         → Main Python scanner script├── api_server.py      → Optional Flask API├── requirements.txt   → Python dependencies└── README.md          → You are here

• nvs-web – Web interface that connects tonvs-core to visualize scans and control actions remotely.

• CLI & Backend:@undertry (Tiago Comba)

This project is licensed under theGPL-2.0 License. See theLICENSE file for details.

“Scan smart. Stay secure.” 🔒