AutoWIFI

Framework de test de pénétration sans fil.
Automatise toute la chaîne d'attaque - de la reconnaissance à l'exploitation - avec une interface terminale propre.

Fonctionnalités

• Attaques multi-vecteurs - WEP (ARP replay, fragmentation, chopchop), WPA/WPA2 (capture handshake, PMKID), WPS (pixie dust, brute force PIN)
• Sélection intelligente de cible - Recommande automatiquement les vecteurs d'attaque en fonction du chiffrement et de la configuration
• Analyse en direct - Découverte réseau en temps réel avec visualisation de la force du signal et suivi des clients
• Plusieurs moteurs de cassage - aircrack-ng, hashcat (GPU), John the Ripper
• Gestion de session - Sauvegarder, restaurer et reprendre les opérations interrompues
• Génération de rapports - Exporter les résultats aux formats HTML, JSON et texte
• Gestion d'interface - Mode moniteur automatique, randomisation MAC, contrôle de canal
• Vérification de handshake - Validation multi-méthode des handshakes capturés
• Découverte de listes de mots - Détection automatique des listes installées (rockyou, seclists, etc.)

Prérequis

• Linux avec une carte sans fil supportant le mode moniteur
• Python 3.9+
• Suite aircrack-ng (requis)
• Optionnel : hashcat, reaver, bully, hcxdumptool, mdk4, macchanger

Installation

Depuis PyPI (recommandé)

pip install autowifi

Installer les dépendances système

Le framework utilise la suite aircrack-ng et les outils associés. Installez-les pour votre 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

Seul aircrack-ng est strictement requis. Le reste débloque des vecteurs d'attaque supplémentaires (WPS, PMKID, cassage GPU, etc.).

Depuis les sources

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

Développement

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

Vérifier l'installation

sudo autowifi --version

Serveur MCP (Intégration d'agent IA)

AutoWIFI inclut un serveur MCP (Model Context Protocol), rendant tous les outils de pentest sans fil disponibles pour les assistants de codage IA comme Claude Code, Codex, Gemini et Cursor.

Installer avec le support MCP

pip install autowifi[mcp]

Configurer pour Claude Code

Ajoutez dans ~/.claude/settings.json :

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

Configurer pour Cursor

Ajoutez dans .cursor/mcp.json :

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

Outils MCP disponibles

Désormais, votre agent IA peut exécuter des pentests sans fil de manière autonome.

Utilisation

Mode interactif

sudo autowifi

Lance l'interface TUI complète avec un flux piloté par menu - scanner, sélectionner la cible, attaquer, casser.

Mode CLI

Scanner les réseaux :

sudo autowifi scan -i wlan0mon -d 30

Capturer le handshake WPA :

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

Casser un fichier de capture :

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

Utiliser le moteur hashcat :

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

Vecteurs d'attaque

Configuration

Les paramètres sont stockés dans ~/.autowifi/config.json. Modifiez-les via le menu interactif ou directement :

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

Structure du projet

autowifi/
  cli.py          - Entry point, interactive mode, CLI commands
  ui.py           - Terminal UI components (Rich-based)
  scanner.py      - Network discovery and client tracking
  attacks.py      - WEP, WPA, WPS, PMKID attack implementations
  handshake.py    - Handshake capture and verification
  cracker.py      - Multi-backend password cracking
  interface.py    - Wireless interface management
  session.py      - Session persistence
  report.py       - HTML/JSON/text report generation
  config.py       - Configuration management
  deps.py         - Dependency checking

Légal

Cet outil est destiné uniquement aux tests de sécurité autorisés et à des fins éducatives. L'accès non autorisé aux réseaux informatiques est illégal. Obtenez toujours une autorisation écrite appropriée avant de tester.

Licence

GPL-3.0