# 1n3/sn1per architecture

> Architecture diagram of the GitHub repository 1n3/sn1per, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/1n3/sn1per
- Repository: https://github.com/1n3/sn1per

## Overview

Sn1per is a command-line offensive-security platform: an operator selects a scan mode, the engine coordinates reconnaissance and security checks, and results are collected for review and reporting. The repository tree shows the engine, mode scripts, configuration profiles, detection templates, and utility scripts; the README documents recon, vulnerability scanning, exploitation, and reporting as core capabilities. Professional UI, workspace, and API features are edition claims, not represented by an identifiable implementation in this Community Edition tree. Some links reflect documented behavior because the main engine source was not sampled.

Main entry points: [`modes`](https://github.com/1n3/sn1per/tree/master/modes) (Scan Modes), [`sniper`](https://github.com/1n3/sn1per/blob/master/sniper) (Sn1per CLI), [`modes/webscan.sh`](https://github.com/1n3/sn1per/blob/master/modes/webscan.sh) (Web Scanning), [`templates`](https://github.com/1n3/sn1per/tree/master/templates) (Detection Templates)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Workflow Control"]
  node_engine["Sn1per CLI"]
  node_profiles["Scan Profiles"]
  node_modes["Scan Modes"]
end

subgraph group_assessment["Security Assessment"]
  node_recon["Reconnaissance<br/>[recon.sh]"]
  node_osint["OSINT<br/>[osint.sh]"]
  node_network["Network Scanning<br/>[massportscan.sh]"]
  node_web["Web Scanning<br/>[webscan.sh]"]
  node_static["Static Search"]
  node_templates["Detection Templates"]
  node_active["Active Checks"]
  node_passive["Passive Checks"]
  node_subdomain["Subdomain Search"]
  node_wayback["Archive Recon<br/>[waybackurls.py]"]
  node_robots["Robots Recon<br/>[waybackrobots.py]"]
end

subgraph group_integrations["Tools and Integrations"]
  node_external_tools["Security Tools"]
  node_github["GitHub API"]
  node_archive["Web Archive"]
  node_zap["OWASP ZAP"]
end

subgraph group_results["Results and Reporting"]
  node_loot[("Findings and Loot")]
  node_report["Report Utilities<br/>[report.py]"]
  node_pdf["PDF Converter<br/>[pyText2pdf.py]"]
  node_screenshot["Web Screenshots<br/>[webscreenshot.py]"]
end

node_operator(("Operator"))

node_operator -->|"runs"| node_engine
node_engine -->|"loads settings"| node_profiles
node_engine -->|"dispatches"| node_modes
node_modes -->|"selects"| node_recon
node_modes -->|"selects"| node_osint
node_modes -->|"selects"| node_network
node_modes -->|"selects"| node_web
node_modes -->|"selects"| node_static
node_recon -->|"invokes"| node_external_tools
node_osint -->|"invokes"| node_external_tools
node_network -->|"invokes"| node_external_tools
node_web -->|"invokes"| node_external_tools
node_web -->|"uses checks"| node_templates
node_templates -->|"includes"| node_active
node_templates -->|"includes"| node_passive
node_active -->|"runs checks"| node_external_tools
node_passive -->|"runs checks"| node_external_tools
node_engine -->|"records results"| node_loot
node_loot -->|"supplies findings"| node_report
node_report -->|"converts text"| node_pdf
node_web -.->|"captures targets"| node_screenshot
node_screenshot -->|"uses renderer"| node_external_tools
node_operator -->|"runs"| node_subdomain
node_subdomain -->|"searches code"| node_github
node_operator -->|"runs"| node_wayback
node_wayback -->|"queries"| node_archive
node_operator -->|"runs"| node_robots
node_robots -->|"queries"| node_archive
node_operator -.->|"configures scan"| node_zap

click node_engine "https://github.com/1n3/sn1per/blob/master/sniper"
click node_profiles "https://github.com/1n3/sn1per/tree/master/conf"
click node_modes "https://github.com/1n3/sn1per/tree/master/modes"
click node_recon "https://github.com/1n3/sn1per/blob/master/modes/recon.sh"
click node_osint "https://github.com/1n3/sn1per/blob/master/modes/osint.sh"
click node_network "https://github.com/1n3/sn1per/blob/master/modes/massportscan.sh"
click node_web "https://github.com/1n3/sn1per/blob/master/modes/webscan.sh"
click node_static "https://github.com/1n3/sn1per/blob/master/modes/static-grep-search.sh"
click node_templates "https://github.com/1n3/sn1per/tree/master/templates"
click node_active "https://github.com/1n3/sn1per/tree/master/templates/active"
click node_passive "https://github.com/1n3/sn1per/tree/master/templates/passive"
click node_loot "https://github.com/1n3/sn1per/tree/master/loot"
click node_report "https://github.com/1n3/sn1per/blob/master/bin/report.py"
click node_pdf "https://github.com/1n3/sn1per/blob/master/bin/pyText2pdf.py"
click node_screenshot "https://github.com/1n3/sn1per/blob/master/bin/webscreenshot.py"
click node_subdomain "https://github.com/1n3/sn1per/blob/master/bin/github-subdomains.py"
click node_wayback "https://github.com/1n3/sn1per/blob/master/bin/waybackurls.py"
click node_robots "https://github.com/1n3/sn1per/blob/master/bin/waybackrobots.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_engine,node_profiles,node_modes toneBlue
class node_recon,node_osint,node_network,node_web,node_static,node_templates,node_active,node_passive,node_subdomain,node_wayback,node_robots toneAmber
class node_external_tools,node_github,node_archive,node_zap toneMint
class node_loot,node_report,node_pdf,node_screenshot toneRose
class node_operator toneIndigo
```

## Components

### Workflow Control

- [Sn1per CLI](https://github.com/1n3/sn1per/blob/master/sniper): `sniper`
- [Scan Profiles](https://github.com/1n3/sn1per/tree/master/conf): `conf`
- [Scan Modes](https://github.com/1n3/sn1per/tree/master/modes): `modes`

### Security Assessment

- [Reconnaissance](https://github.com/1n3/sn1per/blob/master/modes/recon.sh): `modes/recon.sh`
- [OSINT](https://github.com/1n3/sn1per/blob/master/modes/osint.sh): `modes/osint.sh`
- [Network Scanning](https://github.com/1n3/sn1per/blob/master/modes/massportscan.sh): `modes/massportscan.sh`
- [Web Scanning](https://github.com/1n3/sn1per/blob/master/modes/webscan.sh): `modes/webscan.sh`
- [Static Search](https://github.com/1n3/sn1per/blob/master/modes/static-grep-search.sh): `modes/static-grep-search.sh`
- [Detection Templates](https://github.com/1n3/sn1per/tree/master/templates): `templates`
- [Active Checks](https://github.com/1n3/sn1per/tree/master/templates/active): `templates/active`
- [Passive Checks](https://github.com/1n3/sn1per/tree/master/templates/passive): `templates/passive`
- [Subdomain Search](https://github.com/1n3/sn1per/blob/master/bin/github-subdomains.py): `bin/github-subdomains.py`
- [Archive Recon](https://github.com/1n3/sn1per/blob/master/bin/waybackurls.py): `bin/waybackurls.py`
- [Robots Recon](https://github.com/1n3/sn1per/blob/master/bin/waybackrobots.py): `bin/waybackrobots.py`

### Tools and Integrations

- **Security Tools**
- **GitHub API**
- **Web Archive**
- **OWASP ZAP**

### Results and Reporting

- [Findings and Loot](https://github.com/1n3/sn1per/tree/master/loot): `loot`
- [Report Utilities](https://github.com/1n3/sn1per/blob/master/bin/report.py): `bin/report.py`
- [PDF Converter](https://github.com/1n3/sn1per/blob/master/bin/pyText2pdf.py): `bin/pyText2pdf.py`
- [Web Screenshots](https://github.com/1n3/sn1per/blob/master/bin/webscreenshot.py): `bin/webscreenshot.py`

### Other components

- **Operator**

## Connections

- Operator → Sn1per CLI: runs
- Sn1per CLI → Scan Profiles: loads settings
- Sn1per CLI → Scan Modes: dispatches
- Scan Modes → Reconnaissance: selects
- Scan Modes → OSINT: selects
- Scan Modes → Network Scanning: selects
- Scan Modes → Web Scanning: selects
- Scan Modes → Static Search: selects
- Reconnaissance → Security Tools: invokes
- OSINT → Security Tools: invokes
- Network Scanning → Security Tools: invokes
- Web Scanning → Security Tools: invokes
- Web Scanning → Detection Templates: uses checks
- Detection Templates → Active Checks: includes
- Detection Templates → Passive Checks: includes
- Active Checks → Security Tools: runs checks
- Passive Checks → Security Tools: runs checks
- Sn1per CLI → Findings and Loot: records results
- Findings and Loot → Report Utilities: supplies findings
- Report Utilities → PDF Converter: converts text
- Web Scanning → Web Screenshots: captures targets
- Web Screenshots → Security Tools: uses renderer
- Operator → Subdomain Search: runs
- Subdomain Search → GitHub API: searches code
- Operator → Archive Recon: runs
- Archive Recon → Web Archive: queries
- Operator → Robots Recon: runs
- Robots Recon → Web Archive: queries
- Operator → OWASP ZAP: configures scan
