# nocturne-cybersecurity/nocturne-attack architecture

> Architecture diagram of the GitHub repository nocturne-cybersecurity/nocturne-attack, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nocturne-cybersecurity/nocturne-attack
- Repository: https://github.com/nocturne-cybersecurity/nocturne-attack

## Overview

Nocturne is a Python network and web security stress-testing tool. Users can start its interactive interface or invoke documented scan and stress-test modes; the README identifies port scanning, HTTP/TCP floods, Slowloris, DDoS simulation, language settings, and optional Tor routing. The runtime is primarily a monolith in `nocturne.py`; `cli.py` delegates to a minimal `core.py` stub. The excerpts show selected attack implementations and Tor setup, but not all dispatch or integration paths, so those documented links use the README as evidence.

Main entry points: [`nocturne.py`](https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py) (Interactive interface), [`cli.py`](https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/cli.py) (CLI entry point), [`core.py`](https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/core.py) (CLI dispatcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interfaces"]
  node_interactive["Interactive interface<br/>[nocturne.py]"]
  node_cli["CLI entry point<br/>[cli.py]"]
  node_core["CLI dispatcher<br/>[core.py]"]
end

subgraph group_attacks["Network tests"]
  node_portscan["Port scanning<br/>[nocturne.py]"]
  node_httpflood["HTTP flood<br/>[nocturne.py]"]
  node_tcpflood["TCP flood<br/>[nocturne.py]"]
  node_slowloris["Slowloris<br/>[nocturne.py]"]
  node_ddos["DDoS simulation<br/>[nocturne.py]"]
end

subgraph group_settings["Configuration and language"]
  node_config["Configuration<br/>[nocturne.py]"]
  node_language["Translations<br/>[nocturne.py]"]
end

subgraph group_routing["Tor routing"]
  node_tor["Tor controller<br/>[nocturne.py]"]
  node_torservice(("Tor service"))
end

node_user(("Operator"))
node_target(("Authorized target"))

node_user -->|"starts"| node_interactive
node_user -->|"invokes"| node_cli
node_cli -->|"delegates to"| node_core
node_interactive -->|"loads"| node_config
node_interactive -->|"dispatches"| node_portscan
node_interactive -->|"dispatches"| node_httpflood
node_interactive -->|"dispatches"| node_tcpflood
node_interactive -->|"dispatches"| node_slowloris
node_interactive -->|"dispatches"| node_ddos
node_portscan -->|"scans ports"| node_target
node_httpflood -->|"sends requests"| node_target
node_tcpflood -->|"opens connections"| node_target
node_slowloris -->|"holds sockets"| node_target
node_ddos -->|"simulates load"| node_target
node_portscan -->|"formats messages"| node_language
node_httpflood -->|"formats messages"| node_language
node_slowloris -->|"formats messages"| node_language
node_tor -->|"controls"| node_torservice
node_user -->|"changes settings"| node_config
node_httpflood -.->|"may route through"| node_tor

click node_interactive "https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py"
click node_cli "https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/cli.py"
click node_core "https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/core.py"
click node_config "https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py"
click node_language "https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py"
click node_portscan "https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py"
click node_httpflood "https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py"
click node_tcpflood "https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py"
click node_slowloris "https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py"
click node_ddos "https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py"
click node_tor "https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_interactive,node_cli,node_core toneBlue
class node_portscan,node_httpflood,node_tcpflood,node_slowloris,node_ddos toneAmber
class node_config,node_language toneMint
class node_tor,node_torservice toneRose
class node_user,node_target toneIndigo
```

## Components

### User interfaces

- [Interactive interface](https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py): `nocturne.py`
- [CLI entry point](https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/cli.py): `cli.py`
- [CLI dispatcher](https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/core.py): `core.py`

### Network tests

- [Port scanning](https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py): `nocturne.py`
- [HTTP flood](https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py): `nocturne.py`
- [TCP flood](https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py): `nocturne.py`
- [Slowloris](https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py): `nocturne.py`
- [DDoS simulation](https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py): `nocturne.py`

### Configuration and language

- [Configuration](https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py): `nocturne.py`
- [Translations](https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py): `nocturne.py`

### Tor routing

- [Tor controller](https://github.com/nocturne-cybersecurity/nocturne-attack/blob/main/nocturne.py): `nocturne.py`
- **Tor service**

### Other components

- **Operator**
- **Authorized target**

## Connections

- Operator → Interactive interface: starts (evidence: `README.md`)
- Operator → CLI entry point: invokes (evidence: `README.md`)
- CLI entry point → CLI dispatcher: delegates to (evidence: `cli.py`)
- Interactive interface → Configuration: loads (evidence: `nocturne.py`)
- Interactive interface → Port scanning: dispatches (evidence: `README.md`)
- Interactive interface → HTTP flood: dispatches (evidence: `README.md`)
- Interactive interface → TCP flood: dispatches (evidence: `README.md`)
- Interactive interface → Slowloris: dispatches (evidence: `README.md`)
- Interactive interface → DDoS simulation: dispatches (evidence: `README.md`)
- Port scanning → Authorized target: scans ports (evidence: `nocturne.py`)
- HTTP flood → Authorized target: sends requests (evidence: `README.md`)
- TCP flood → Authorized target: opens connections (evidence: `README.md`)
- Slowloris → Authorized target: holds sockets (evidence: `README.md`)
- DDoS simulation → Authorized target: simulates load (evidence: `README.md`)
- Port scanning → Translations: formats messages (evidence: `nocturne.py`)
- HTTP flood → Translations: formats messages (evidence: `nocturne.py`)
- Slowloris → Translations: formats messages (evidence: `nocturne.py`)
- Tor controller → Tor service: controls (evidence: `nocturne.py`)
- Operator → Configuration: changes settings (evidence: `README.md`)
- HTTP flood → Tor controller: may route through (evidence: `nocturne.py`)
