# kr1shna35/awsprowl architecture

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

- Interactive diagram: https://gitdiagram.com/kr1shna35/awsprowl
- Repository: https://github.com/kr1shna35/awsprowl

## Overview

awsProwl is an operator-facing AWS security research framework for authorized assessments. Its main workflow starts in the CLI or interactive interface, configures AWS access, runs service scans or security modules, reviews findings, and exports reports. The product also includes analysis for privilege escalation, attack paths, network exposure, CI/CD, and compliance, plus six risk-oriented module categories. The README documents these capabilities; unsampled subsystems are represented at directory paths, and their internal call relationships are not asserted.

Main entry points: [`src/awsprowl/cli/ui/handlers.py`](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/cli/ui/handlers.py) (Module handlers), [`src/awsprowl/cli/main.py`](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/cli/main.py) (CLI entry), [`src/awsprowl/analysis/findings.py`](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/analysis/findings.py) (Finding models), [`src/awsprowl/cli/ui/tui.py`](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/cli/ui/tui.py) (Module browser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Operator interfaces"]
  node_cli["CLI entry<br/>[main.py]"]
  node_interactive["Interactive shell<br/>[interactive.py]"]
  node_tui["Module browser<br/>[tui.py]"]
  node_handlers["Module handlers<br/>[handlers.py]"]
end

subgraph group_runtime["Scan runtime"]
  node_config["Configuration<br/>[config.py]"]
  node_auth["AWS credentials<br/>[auth.py]"]
  node_orchestrator["Scan orchestration<br/>[orchestrator.py]"]
  node_parallel["Parallel scanning<br/>[base.py]"]
  node_scanners["Service scanners"]
end

subgraph group_modules["Security modules"]
  node_enum["Enumeration<br/>[__init__.py]"]
  node_privesc["Privilege escalation<br/>[__init__.py]"]
  node_active["Active operations<br/>[__init__.py]"]
  node_persistence["Persistence and backdoors<br/>[__init__.py]"]
  node_exfil["Data exfiltration<br/>[__init__.py]"]
end

subgraph group_analysis["Assessment analysis"]
  node_analysis["Security analysis"]
end

subgraph group_results["Findings and reports"]
  node_findings["Finding models<br/>[findings.py]"]
  node_reports["Report formatters<br/>[formatters.py]"]
  node_session[("Session storage<br/>[session.py]")]
end

node_operator(("Security operator"))

node_operator -->|"invokes"| node_cli
node_cli -->|"loads config"| node_config
node_cli -->|"launches shell"| node_interactive
node_cli -->|"launches browser"| node_tui
node_operator -.->|"uses"| node_tui
node_interactive -.->|"uses browser"| node_tui
node_tui -->|"dispatches modules"| node_handlers
node_handlers -->|"uses credentials"| node_auth
node_handlers -->|"calls service APIs"| node_scanners
node_operator -.->|"requests scan"| node_orchestrator
node_orchestrator -->|"runs scans"| node_parallel
node_parallel -->|"dispatches scans"| node_scanners
node_auth -->|"supplies access"| node_scanners
node_enum -.->|"supports modules"| node_handlers
node_privesc -.->|"analyzes paths"| node_analysis
node_active -.->|"executes actions"| node_handlers
node_persistence -.->|"executes actions"| node_handlers
node_exfil -.->|"exports data"| node_handlers
node_analysis -.->|"produces findings"| node_findings
node_scanners -.->|"records results"| node_findings
node_findings -->|"formats output"| node_reports
node_findings -.->|"stores sessions"| node_session

click node_cli "https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/cli/main.py"
click node_interactive "https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/cli/interactive.py"
click node_tui "https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/cli/ui/tui.py"
click node_handlers "https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/cli/ui/handlers.py"
click node_config "https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/core/config.py"
click node_auth "https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/core/auth.py"
click node_orchestrator "https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/aws/orchestrator.py"
click node_parallel "https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/aws/base.py"
click node_scanners "https://github.com/kr1shna35/awsprowl/tree/main/src/awsprowl/aws"
click node_enum "https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/modules/enum/__init__.py"
click node_privesc "https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/modules/privesc/__init__.py"
click node_active "https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/modules/exploit/__init__.py"
click node_persistence "https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/modules/persist/__init__.py"
click node_exfil "https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/modules/exfil/__init__.py"
click node_analysis "https://github.com/kr1shna35/awsprowl/tree/main/src/awsprowl/analysis"
click node_findings "https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/analysis/findings.py"
click node_reports "https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/reports/formatters.py"
click node_session "https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/core/session.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_cli,node_interactive,node_tui,node_handlers toneBlue
class node_config,node_auth,node_orchestrator,node_parallel,node_scanners toneAmber
class node_enum,node_privesc,node_active,node_persistence,node_exfil toneMint
class node_analysis toneRose
class node_findings,node_reports,node_session,node_operator toneIndigo
```

## Components

### Operator interfaces

- [CLI entry](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/cli/main.py): `src/awsprowl/cli/main.py`
- [Interactive shell](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/cli/interactive.py): `src/awsprowl/cli/interactive.py`
- [Module browser](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/cli/ui/tui.py): `src/awsprowl/cli/ui/tui.py`
- [Module handlers](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/cli/ui/handlers.py): `src/awsprowl/cli/ui/handlers.py`

### Scan runtime

- [Configuration](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/core/config.py): `src/awsprowl/core/config.py`
- [AWS credentials](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/core/auth.py): `src/awsprowl/core/auth.py`
- [Scan orchestration](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/aws/orchestrator.py): `src/awsprowl/aws/orchestrator.py`
- [Parallel scanning](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/aws/base.py): `src/awsprowl/aws/base.py`
- [Service scanners](https://github.com/kr1shna35/awsprowl/tree/main/src/awsprowl/aws): `src/awsprowl/aws`

### Security modules

- [Enumeration](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/modules/enum/__init__.py): `src/awsprowl/modules/enum/__init__.py`
- [Privilege escalation](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/modules/privesc/__init__.py): `src/awsprowl/modules/privesc/__init__.py`
- [Active operations](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/modules/exploit/__init__.py): `src/awsprowl/modules/exploit/__init__.py`
- [Persistence and backdoors](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/modules/persist/__init__.py): `src/awsprowl/modules/persist/__init__.py`
- [Data exfiltration](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/modules/exfil/__init__.py): `src/awsprowl/modules/exfil/__init__.py`

### Assessment analysis

- [Security analysis](https://github.com/kr1shna35/awsprowl/tree/main/src/awsprowl/analysis): `src/awsprowl/analysis`

### Findings and reports

- [Finding models](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/analysis/findings.py): `src/awsprowl/analysis/findings.py`
- [Report formatters](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/reports/formatters.py): `src/awsprowl/reports/formatters.py`
- [Session storage](https://github.com/kr1shna35/awsprowl/blob/main/src/awsprowl/core/session.py): `src/awsprowl/core/session.py`

### Other components

- **Security operator**

## Connections

- Security operator → CLI entry: invokes (evidence: `src/awsprowl/cli/main.py`)
- CLI entry → Configuration: loads config (evidence: `src/awsprowl/cli/main.py`)
- CLI entry → Interactive shell: launches shell (evidence: `src/awsprowl/cli/main.py`)
- CLI entry → Module browser: launches browser (evidence: `src/awsprowl/cli/main.py`)
- Security operator → Module browser: uses
- Interactive shell → Module browser: uses browser (evidence: `src/awsprowl/cli/interactive.py`)
- Module browser → Module handlers: dispatches modules (evidence: `src/awsprowl/cli/ui/tui.py`)
- Module handlers → AWS credentials: uses credentials (evidence: `src/awsprowl/cli/ui/handlers.py`)
- Module handlers → Service scanners: calls service APIs (evidence: `src/awsprowl/cli/ui/handlers.py`)
- Security operator → Scan orchestration: requests scan
- Scan orchestration → Parallel scanning: runs scans (evidence: `src/awsprowl/aws/orchestrator.py`)
- Parallel scanning → Service scanners: dispatches scans (evidence: `src/awsprowl/aws/base.py`)
- AWS credentials → Service scanners: supplies access (evidence: `src/awsprowl/aws/base.py`)
- Enumeration → Module handlers: supports modules
- Privilege escalation → Security analysis: analyzes paths
- Active operations → Module handlers: executes actions
- Persistence and backdoors → Module handlers: executes actions
- Data exfiltration → Module handlers: exports data
- Security analysis → Finding models: produces findings
- Service scanners → Finding models: records results
- Finding models → Report formatters: formats output (evidence: `src/awsprowl/reports/formatters.py`)
- Finding models → Session storage: stores sessions
