AutoWIFI

Kabelloses Penetrationstest-Framework.
Automatisiert die gesamte Angriffskette – von der Aufklärung bis zur Ausbeutung – mit einer sauberen Terminal-Oberfläche.

Funktionen

• Mehrvektor-Angriffe – WEP (ARP-Replay, Fragmentierung, Chopchop), WPA/WPA2 (Handshake-Erfassung, PMKID), WPS (Pixie Dust, PIN-Brute-Force)
• Intelligente Zielauswahl – Automatische Empfehlung von Angriffsvektoren basierend auf Zielverschlüsselung und -konfiguration
• Live-Scan – Echtzeit-Netzwerkentdeckung mit Signalstärke-Visualisierung und Client-Verfolgung
• Mehrere Crack-Backends – aircrack-ng, hashcat (GPU), John the Ripper
• Sitzungsverwaltung – Unterbrochene Vorgänge speichern, wiederherstellen und fortsetzen
• Berichtserstellung – Ergebnisse im HTML-, JSON- und Textformat exportieren
• Schnittstellenverwaltung – Automatischer Monitor-Modus, MAC-Zufallsgenerierung, Kanalsteuerung
• Handshake-Verifizierung – Mehrfache Validierung von erfassten Handshakes
• Wörterbuch-Erkennung – Automatische Erkennung installierter Wörterlisten (rockyou, seclists, usw.)

Voraussetzungen

• Linux mit einem WLAN-Adapter, der den Monitor-Modus unterstützt
• Python 3.9+
• aircrack-ng-Suite (erforderlich)
• Optional: hashcat, reaver, bully, hcxdumptool, mdk4, macchanger

Installation

Von PyPI (empfohlen)

pip install autowifi

Systemabhängigkeiten installieren

Das Framework nutzt die aircrack-ng-Suite und verwandte Werkzeuge. Installieren Sie diese für Ihre Distribution:

Debian / Ubuntu / Kali:

sudo apt update
sudo apt install -y aircrack-ng reaver bully hcxdumptool hcxtools hashcat macchanger mdk4 tshark

Arch Linux:

sudo pacman -S aircrack-ng reaver hashcat hcxdumptool hcxtools macchanger wireshark-cli

Fedora:

sudo dnf install aircrack-ng reaver hashcat hcxdumptool hcxtools macchanger wireshark-cli

Nur aircrack-ng ist zwingend erforderlich. Die restlichen Werkzeuge schalten zusätzliche Angriffsvektoren frei (WPS, PMKID, GPU-Cracking, usw.).

Aus dem Quellcode

git clone https://github.com/momenbasel/AutoWIFI.git
cd AutoWIFI
pip install .

Entwicklung

git clone https://github.com/momenbasel/AutoWIFI.git
cd AutoWIFI
pip install -e .

Installation überprüfen

sudo autowifi --version

MCP-Server (KI-Agenten-Integration)

AutoWIFI enthält einen MCP-Server (Model Context Protocol), der alle Werkzeuge für drahtlose Penetrationstests KI-Assistenten wie Claude Code, Codex, Gemini und Cursor zur Verfügung stellt.

Mit MCP-Unterstützung installieren

pip install autowifi[mcp]

Für Claude Code konfigurieren

Fügen Sie in ~/.claude/settings.json hinzu:

{
  "mcpServers": {
    "autowifi": {
      "command": "autowifi-mcp"
    }
  }
}

Für Cursor konfigurieren

Fügen Sie in .cursor/mcp.json hinzu:

{
  "mcpServers": {
    "autowifi": {
      "command": "autowifi-mcp"
    }
  }
}

Verfügbare MCP-Werkzeuge

Jetzt kann Ihr KI-Agent selbstständig drahtlose Penetrationstests durchführen.

Nutzung

Interaktiver Modus

sudo autowifi

Startet die vollständige TUI mit menügesteuertem Workflow – scannen, Ziel auswählen, angreifen, knacken.

CLI-Modus

Netzwerke scannen:

sudo autowifi scan -i wlan0mon -d 30

WPA-Handshake erfassen:

sudo autowifi capture -i wlan0mon -b AA:BB:CC:DD:EE:FF -c 6 -t 120

Eine Erfassungsdatei knacken:

sudo autowifi crack handshake.cap -w /usr/share/wordlists/rockyou.txt

hashcat-Backend verwenden:

sudo autowifi crack handshake.cap -w rockyou.txt --backend hashcat

Angriffsvektoren

Konfiguration

Einstellungen werden in ~/.autowifi/config.json gespeichert. Über das interaktive Menü oder direkt bearbeiten:

{
  "interface": "wlan0",
  "scan_duration": 30,
  "deauth_count": 15,
  "handshake_timeout": 180,
  "default_wordlist": "/usr/share/wordlists/rockyou.txt",
  "crack_backend": "aircrack",
  "mac_randomize": false,
  "auto_crack": true
}

Projektstruktur

autowifi/
  cli.py          - Einstiegspunkt, interaktiver Modus, CLI-Befehle
  ui.py           - Terminal-UI-Komponenten (Rich-basiert)
  scanner.py      - Netzwerkentdeckung und Client-Verfolgung
  attacks.py      - Implementierung von WEP-, WPA-, WPS-, PMKID-Angriffen
  handshake.py    - Handshake-Erfassung und -Verifizierung
  cracker.py      - Multi-Backend-Passwortknacken
  interface.py    - Verwaltung drahtloser Schnittstellen
  session.py      - Sitzungspersistenz
  report.py       - HTML/JSON/Text-Berichtserstellung
  config.py       - Konfigurationsverwaltung
  deps.py         - Abhängigkeitsprüfung

Rechtliches

Dieses Tool ist ausschließlich für autorisierte Sicherheitstests und Bildungszwecke bestimmt. Der unbefugte Zugriff auf Computernetzwerke ist illegal. Holen Sie stets eine ordnungsgemäße schriftliche Genehmigung ein, bevor Sie Tests durchführen.

Lizenz

GPL-3.0