# momenbasel/autowifi architecture

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

- Interactive diagram: https://gitdiagram.com/momenbasel/autowifi
- Repository: https://github.com/momenbasel/autowifi

## Overview

AutoWIFI is a Linux wireless penetration-testing framework with both an interactive/CLI interface and an MCP server for AI-agent clients. Its principal workflow is to manage a wireless interface, discover networks and clients, select an attack suited to the target, capture or extract credentials, and optionally crack captures. Sessions, configuration, dependency checks, and report generation support that workflow. The source excerpts show several direct calls; other capability links below rely on README documentation, so unsampled implementation details are not inferred.

Main entry points: [`autowifi/cli.py`](https://github.com/momenbasel/autowifi/blob/main/autowifi/cli.py) (CLI and workflow), [`autowifi/mcp_server.py`](https://github.com/momenbasel/autowifi/blob/main/autowifi/mcp_server.py) (MCP server), [`autowifi/cracker.py`](https://github.com/momenbasel/autowifi/blob/main/autowifi/cracker.py) (Password cracking), [`autowifi/attacks.py`](https://github.com/momenbasel/autowifi/blob/main/autowifi/attacks.py) (WPA capture)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry points"]
  node_cli["CLI and workflow<br/>[cli.py]"]
  node_mcp["MCP server<br/>[mcp_server.py]"]
  node_terminal["Terminal UI<br/>[ui.py]"]
end

subgraph group_discovery["Discovery and setup"]
  node_interface["Interface management<br/>[interface.py]"]
  node_scanner["Network scanning<br/>[scanner.py]"]
end

subgraph group_attacks["Attack operations"]
  node_recommendations["Attack selection<br/>[attacks.py]"]
  node_wep["WEP attacks<br/>[attacks.py]"]
  node_wpa["WPA capture<br/>[attacks.py]"]
  node_wps["WPS attacks<br/>[attacks.py]"]
  node_pmkid["PMKID capture<br/>[attacks.py]"]
end

subgraph group_analysis["Credential analysis"]
  node_handshake["Handshake validation<br/>[handshake.py]"]
  node_cracker["Password cracking<br/>[cracker.py]"]
  node_wordlists["Wordlist discovery<br/>[cracker.py]"]
end

subgraph group_support["Workflow support"]
  node_config["Configuration<br/>[config.py]"]
  node_dependencies["Dependency checks<br/>[deps.py]"]
  node_sessions[("Session management<br/>[session.py]")]
  node_reports["Report generation<br/>[report.py]"]
end

node_operator(("Operator"))
node_agent(("AI agent"))
node_wireless["Wireless tool suite"]

node_operator -->|"runs commands"| node_cli
node_operator -->|"uses interface"| node_terminal
node_agent -->|"invokes tools"| node_mcp
node_cli -->|"renders workflow"| node_terminal
node_cli -->|"loads settings"| node_config
node_cli -->|"manages adapter"| node_interface
node_cli -->|"runs scan"| node_scanner
node_cli -->|"selects attacks"| node_recommendations
node_cli -->|"runs attack"| node_wep
node_cli -->|"captures handshake"| node_wpa
node_cli -->|"runs attack"| node_wps
node_cli -->|"captures PMKID"| node_pmkid
node_cli -->|"cracks capture"| node_cracker
node_cli -->|"manages sessions"| node_sessions
node_cli -->|"exports findings"| node_reports
node_cli -->|"checks tools"| node_dependencies
node_mcp -->|"controls adapter"| node_interface
node_mcp -->|"scans networks"| node_scanner
node_mcp -->|"gets suggestions"| node_recommendations
node_mcp -->|"captures handshake"| node_wpa
node_mcp -->|"captures PMKID"| node_pmkid
node_mcp -->|"runs pixie attack"| node_wps
node_mcp -->|"cracks capture"| node_cracker
node_mcp -->|"verifies capture"| node_handshake
node_mcp -->|"checks tools"| node_dependencies
node_scanner -->|"discovers networks"| node_wireless
node_interface -->|"controls radio"| node_wireless
node_wep -->|"executes vectors"| node_wireless
node_wpa -->|"validates capture"| node_handshake
node_wpa -->|"captures traffic"| node_wireless
node_wps -->|"executes vectors"| node_wireless
node_pmkid -->|"extracts PMKID"| node_wireless
node_handshake -->|"converts captures"| node_cracker
node_cracker -->|"uses cracking tools"| node_wireless
node_cracker -->|"uses wordlists"| node_wordlists

click node_cli "https://github.com/momenbasel/autowifi/blob/main/autowifi/cli.py"
click node_mcp "https://github.com/momenbasel/autowifi/blob/main/autowifi/mcp_server.py"
click node_terminal "https://github.com/momenbasel/autowifi/blob/main/autowifi/ui.py"
click node_config "https://github.com/momenbasel/autowifi/blob/main/autowifi/config.py"
click node_interface "https://github.com/momenbasel/autowifi/blob/main/autowifi/interface.py"
click node_scanner "https://github.com/momenbasel/autowifi/blob/main/autowifi/scanner.py"
click node_dependencies "https://github.com/momenbasel/autowifi/blob/main/autowifi/deps.py"
click node_recommendations "https://github.com/momenbasel/autowifi/blob/main/autowifi/attacks.py"
click node_wep "https://github.com/momenbasel/autowifi/blob/main/autowifi/attacks.py"
click node_wpa "https://github.com/momenbasel/autowifi/blob/main/autowifi/attacks.py"
click node_wps "https://github.com/momenbasel/autowifi/blob/main/autowifi/attacks.py"
click node_pmkid "https://github.com/momenbasel/autowifi/blob/main/autowifi/attacks.py"
click node_handshake "https://github.com/momenbasel/autowifi/blob/main/autowifi/handshake.py"
click node_cracker "https://github.com/momenbasel/autowifi/blob/main/autowifi/cracker.py"
click node_wordlists "https://github.com/momenbasel/autowifi/blob/main/autowifi/cracker.py"
click node_sessions "https://github.com/momenbasel/autowifi/blob/main/autowifi/session.py"
click node_reports "https://github.com/momenbasel/autowifi/blob/main/autowifi/report.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_mcp,node_terminal toneBlue
class node_interface,node_scanner toneAmber
class node_recommendations,node_wep,node_wpa,node_wps,node_pmkid toneMint
class node_handshake,node_cracker,node_wordlists toneRose
class node_config,node_dependencies,node_sessions,node_reports,node_operator,node_agent,node_wireless toneIndigo
```

## Components

### Entry points

- [CLI and workflow](https://github.com/momenbasel/autowifi/blob/main/autowifi/cli.py): `autowifi/cli.py`
- [MCP server](https://github.com/momenbasel/autowifi/blob/main/autowifi/mcp_server.py): `autowifi/mcp_server.py`
- [Terminal UI](https://github.com/momenbasel/autowifi/blob/main/autowifi/ui.py): `autowifi/ui.py`

### Discovery and setup

- [Interface management](https://github.com/momenbasel/autowifi/blob/main/autowifi/interface.py): `autowifi/interface.py`
- [Network scanning](https://github.com/momenbasel/autowifi/blob/main/autowifi/scanner.py): `autowifi/scanner.py`

### Attack operations

- [Attack selection](https://github.com/momenbasel/autowifi/blob/main/autowifi/attacks.py): `autowifi/attacks.py`
- [WEP attacks](https://github.com/momenbasel/autowifi/blob/main/autowifi/attacks.py): `autowifi/attacks.py`
- [WPA capture](https://github.com/momenbasel/autowifi/blob/main/autowifi/attacks.py): `autowifi/attacks.py`
- [WPS attacks](https://github.com/momenbasel/autowifi/blob/main/autowifi/attacks.py): `autowifi/attacks.py`
- [PMKID capture](https://github.com/momenbasel/autowifi/blob/main/autowifi/attacks.py): `autowifi/attacks.py`

### Credential analysis

- [Handshake validation](https://github.com/momenbasel/autowifi/blob/main/autowifi/handshake.py): `autowifi/handshake.py`
- [Password cracking](https://github.com/momenbasel/autowifi/blob/main/autowifi/cracker.py): `autowifi/cracker.py`
- [Wordlist discovery](https://github.com/momenbasel/autowifi/blob/main/autowifi/cracker.py): `autowifi/cracker.py`

### Workflow support

- [Configuration](https://github.com/momenbasel/autowifi/blob/main/autowifi/config.py): `autowifi/config.py`
- [Dependency checks](https://github.com/momenbasel/autowifi/blob/main/autowifi/deps.py): `autowifi/deps.py`
- [Session management](https://github.com/momenbasel/autowifi/blob/main/autowifi/session.py): `autowifi/session.py`
- [Report generation](https://github.com/momenbasel/autowifi/blob/main/autowifi/report.py): `autowifi/report.py`

### Other components

- **Operator**
- **AI agent**
- **Wireless tool suite**

## Connections

- Operator → CLI and workflow: runs commands (evidence: `README.md`)
- Operator → Terminal UI: uses interface (evidence: `README.md`)
- AI agent → MCP server: invokes tools (evidence: `README.md`)
- CLI and workflow → Terminal UI: renders workflow (evidence: `autowifi/cli.py`)
- CLI and workflow → Configuration: loads settings (evidence: `autowifi/cli.py`)
- CLI and workflow → Interface management: manages adapter (evidence: `autowifi/cli.py`)
- CLI and workflow → Network scanning: runs scan (evidence: `autowifi/cli.py`)
- CLI and workflow → Attack selection: selects attacks (evidence: `README.md`)
- CLI and workflow → WEP attacks: runs attack (evidence: `autowifi/cli.py`)
- CLI and workflow → WPA capture: captures handshake (evidence: `README.md`)
- CLI and workflow → WPS attacks: runs attack (evidence: `README.md`)
- CLI and workflow → PMKID capture: captures PMKID (evidence: `README.md`)
- CLI and workflow → Password cracking: cracks capture (evidence: `autowifi/cli.py`)
- CLI and workflow → Session management: manages sessions (evidence: `autowifi/cli.py`)
- CLI and workflow → Report generation: exports findings (evidence: `README.md`)
- CLI and workflow → Dependency checks: checks tools (evidence: `autowifi/cli.py`)
- MCP server → Interface management: controls adapter (evidence: `autowifi/mcp_server.py`)
- MCP server → Network scanning: scans networks (evidence: `autowifi/mcp_server.py`)
- MCP server → Attack selection: gets suggestions (evidence: `autowifi/mcp_server.py`)
- MCP server → WPA capture: captures handshake (evidence: `autowifi/mcp_server.py`)
- MCP server → PMKID capture: captures PMKID (evidence: `autowifi/mcp_server.py`)
- MCP server → WPS attacks: runs pixie attack (evidence: `autowifi/mcp_server.py`)
- MCP server → Password cracking: cracks capture (evidence: `autowifi/mcp_server.py`)
- MCP server → Handshake validation: verifies capture (evidence: `autowifi/mcp_server.py`)
- MCP server → Dependency checks: checks tools (evidence: `autowifi/mcp_server.py`)
- Network scanning → Wireless tool suite: discovers networks (evidence: `README.md`)
- Interface management → Wireless tool suite: controls radio (evidence: `README.md`)
- WEP attacks → Wireless tool suite: executes vectors (evidence: `README.md`)
- WPA capture → Handshake validation: validates capture (evidence: `autowifi/attacks.py`)
- WPA capture → Wireless tool suite: captures traffic (evidence: `README.md`)
- WPS attacks → Wireless tool suite: executes vectors (evidence: `README.md`)
- PMKID capture → Wireless tool suite: extracts PMKID (evidence: `README.md`)
- Handshake validation → Password cracking: converts captures (evidence: `README.md`)
- Password cracking → Wireless tool suite: uses cracking tools (evidence: `README.md`)
- Password cracking → Wordlist discovery: uses wordlists (evidence: `README.md`)
