Working Prototype
nmap-llm
An offline Python prototype connecting scan planning, Nmap execution, XML parsing, and local-LLM-assisted triage reporting.
Purpose
Deterministic Execution with Bounded Assistance
Keep scan execution deterministic; use the model for bounded assistance.
nmap-llm is an offline Python prototype that connects scan planning, Nmap execution, XML parsing, and local-LLM-assisted triage reporting. The public repository contains modules for configuration, model interaction, parsing, scanning, and utilities.
Pipeline Architecture
Data stays in a local workflow. The pipeline describes repository structure at a high level and is not a claim of complete safety validation.
Constrained Plan
Define deterministic scan parameters and targets.
Nmap Process
Execute Nmap scanner in a controlled local environment.
XML Parser
Parse raw Nmap XML output into structured data structures.
Local Report Generation
Triage findings using local LLM integration (Ollama) and generate Markdown reports.
Implementation
Core Stack & Modules
Language
Python modules with XML, JSON, and Markdown handling.
Scanner
Nmap execution and result parsing.
Model Integration
Ollama with a local model integration documented by the repository.
Output
Structured triage material and Markdown reporting.
Limitations & Validation Work
No automated test suite was observed during the evidence review. The site therefore does not claim automated coverage. Safety behavior, command constraints, failure handling, and adversarial model output should be validated further before broader operational use.