v2.0.0 Open-source wireless testing

Wireless pentesting,
automated.

Scan networks, capture handshakes, and audit wireless security with one Linux toolkit.

Install from PyPI View Source

Set up your testing environment

AutoWIFI 2.0.0 requires Linux, Python 3.9+, and compatible wireless hardware.

Before you start

A wireless adapter with monitor mode support.
The aircrack-ng suite installed through your distribution.
Optional tools such as hashcat and hcxdumptool for additional workflows.

System dependency instructions

Install and verify

pip install autowifi
sudo autowifi --version

For MCP support, install "autowifi[mcp]". Open the usage guide.

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.

Attack Vectors

Cracking Backends

MCP Tools

3.9+

Python

Seven attack paths, one framework

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

Attack	Encryption	Method
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

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"
    }
  }
}
          

Tool	Description
list_interfaces	List wireless interfaces
enable_monitor	Enable monitor mode
disable_monitor	Disable monitor mode
scan_networks	Discover nearby networks
get_recommended_attacks	Get best attack vectors
capture_handshake	Capture WPA handshake
capture_pmkid	Capture PMKID hash
wps_pixie_dust	Run pixie dust attack
deauth	Deauthenticate clients
crack_handshake	Crack captured handshake
verify_handshake	Verify handshake file
find_wordlists	Locate wordlist files
check_dependencies	Verify tool dependencies

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?

Check your adapter and install the required system tools before your first assessment.

Install from PyPI Read the docs

Wireless pentesting, automated.