v1.0 Full wireless attack chain

Wireless pentesting,
automated.

WPA/WPA2, WEP, and WPS attacks from reconnaissance to cracking in one command. Smart target selection, GPU acceleration, session recovery.

$ pip install autowifi click to copy
autowifi -- scan
# sudo autowifi scan -i wlan0mon -d 30
 
[*] Starting scan on wlan0mon (30s)...
[*] Channels: 1-13 (2.4 GHz) + 36-165 (5 GHz)
 
BSSID CH ENC SIGNAL ESSID
---------------------------------------------------------------------------
A4:CF:12:8B:3E:01 6 WPA2 |||||||||| CorpNet-5G
00:1A:2B:3C:4D:5E 11 WPA2 |||||||||| HomeRouter-2F
F8:E4:3B:7A:22:10 1 WEP |||||||||| Legacy-Printer
B0:6E:BF:44:A1:CC 3 WPA2/WPS |||||||||| CafeWiFi
DC:9F:DB:11:F0:8A 44 WPA2 |||||||||| Lab-Secure
 
[+] Found 5 networks (3 WPA2, 1 WEP, 1 WPS)
[+] Recommended: PMKID attack on CorpNet-5G (strong signal, WPA2)
Features

Full attack chain in one toolkit

From interface setup to cracked keys. Every step automated, every result logged.

Multi-Vector Attacks

WEP (ARP replay, fragmentation, chopchop), WPA/WPA2 (handshake, PMKID), and WPS (pixie dust, PIN brute force) - all from one tool.

Smart Targeting

Auto-recommends the best attack vector based on encryption type, signal strength, WPS status, and client activity.

Live Scanning

Real-time network discovery with signal strength visualization, client enumeration, and channel hopping across 2.4 GHz and 5 GHz bands.

GPU Cracking

Three cracking backends: aircrack-ng (CPU), hashcat (GPU-accelerated), and John the Ripper. Automatic wordlist detection.

Session Management

Save, restore, and resume attack sessions. Never lose progress - pick up exactly where you left off after interruptions.

MCP Server

13-tool Model Context Protocol server. Let AI agents run wireless assessments - scan networks, capture handshakes, crack keys autonomously.

7
Attack Vectors
3
Cracking Backends
13
MCP Tools
3.9+
Python
Attack Vectors

Seven attack paths, one framework

Covers WEP, WPA/WPA2, and WPS with multiple techniques per encryption type.

AttackEncryptionMethod
ARP Replay WEP IV collection via ARP request replay
Fragmentation WEP Keystream recovery through fragmentation
ChopChop WEP KoreK chopchop keystream extraction
Handshake Capture WPA/WPA2 Deauth + 4-way handshake capture
PMKID WPA/WPA2 Clientless key extraction from AP
Pixie Dust WPS Offline WPS PIN recovery via pixie dust
PIN Brute Force WPS Online WPS PIN enumeration
AI Integration

MCP Server for AI agents

Let Claude, Cursor, or any MCP-compatible agent run wireless assessments autonomously with 13 built-in tools.

Drop-in MCP configuration

AutoWIFI ships a built-in Model Context Protocol server. Add it to your AI editor and your agent can scan networks, capture handshakes, crack keys, and generate reports - zero human interaction required.

claude_desktop_config.json
{
  "mcpServers": {
    "autowifi": {
      "command": "autowifi-mcp"
    }
  }
}
ToolDescription
list_interfacesList wireless interfaces
enable_monitorEnable monitor mode
disable_monitorDisable monitor mode
scan_networksDiscover nearby networks
get_recommended_attacksGet best attack vectors
capture_handshakeCapture WPA handshake
capture_pmkidCapture PMKID hash
wps_pixie_dustRun pixie dust attack
deauthDeauthenticate clients
crack_handshakeCrack captured handshake
verify_handshakeVerify handshake file
find_wordlistsLocate wordlist files
check_dependenciesVerify tool dependencies
CLI Usage

Command reference

Scan, capture, and crack - each step is a single command with sensible defaults.

Scan Networks
sudo autowifi scan -i wlan0mon
sudo autowifi scan -i wlan0mon -d 60
sudo autowifi scan -i wlan0mon --band 5
Capture Handshakes
sudo autowifi capture -i wlan0mon -b AA:BB:CC:DD:EE:FF
sudo autowifi pmkid -i wlan0mon -b AA:BB:CC:DD:EE:FF
sudo autowifi deauth -i wlan0mon -b AA:BB:CC:DD:EE:FF
Crack Keys
autowifi crack -f capture.cap -w rockyou.txt
autowifi crack -f capture.cap --backend hashcat
autowifi crack -f pmkid.22000 --backend hashcat
Interface & Session
sudo autowifi monitor enable -i wlan0
sudo autowifi monitor disable -i wlan0mon
autowifi session list
autowifi session restore abc123

Ready to automate wireless assessments?

Install AutoWIFI and go from zero to cracked keys in minutes.

Install v1.0 Read the docs