AutoWIFI

Framework de pruebas de penetración inalámbrica.
Automatiza toda la cadena de ataque – desde el reconocimiento hasta la explotación – con una interfaz de terminal limpia.

Características

• Ataques multi-vector – WEP (ARP replay, fragmentation, chopchop), WPA/WPA2 (captura de handshake, PMKID), WPS (pixie dust, fuerza bruta de PIN)
• Selección inteligente de objetivo – Recomienda automáticamente vectores de ataque según el cifrado y configuración del objetivo
• Escaneo en vivo – Descubrimiento de redes en tiempo real con visualización de intensidad de señal y seguimiento de clientes
• Múltiples backends de cracking – aircrack-ng, hashcat (GPU), John the Ripper
• Gestión de sesiones – Guardar, restaurar y reanudar operaciones interrumpidas
• Generación de informes – Exportar hallazgos en formatos HTML, JSON y texto
• Gestión de interfaz – Modo monitor automático, aleatorización de MAC, control de canal
• Verificación de handshake – Validación multimétodo de handshakes capturados
• Descubrimiento de wordlists – Detección automática de wordlists instaladas (rockyou, seclists, etc.)

Requisitos

• Linux con un adaptador inalámbrico que soporte modo monitor
• Python 3.9+
• Suite aircrack-ng (requerido)
• Opcional: hashcat, reaver, bully, hcxdumptool, mdk4, macchanger

Instalación

Desde PyPI (recomendado)

pip install autowifi

Instalar dependencias del sistema

El framework envuelve la suite aircrack-ng y herramientas relacionadas. Instálelas para su distribución:

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

Solo aircrack-ng es estrictamente necesario. El resto desbloquea vectores de ataque adicionales (WPS, PMKID, cracking por GPU, etc.).

Desde el código fuente

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

Desarrollo

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

Verificar instalación

sudo autowifi --version

Servidor MCP (Integración con Agentes IA)

AutoWIFI incluye un servidor MCP (Model Context Protocol), que pone todas las herramientas de pentesting inalámbrico a disposición de asistentes de codificación IA como Claude Code, Codex, Gemini y Cursor.

Instalar con soporte MCP

pip install autowifi[mcp]

Configurar para Claude Code

Añadir a ~/.claude/settings.json:

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

Configurar para Cursor

Añadir a .cursor/mcp.json:

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

Herramientas MCP disponibles

Ahora su agente IA puede realizar pruebas de penetración inalámbrica de forma autónoma.

Uso

Modo interactivo

sudo autowifi

Lanza la TUI completa con flujo de trabajo basado en menús – escanear, seleccionar objetivo, atacar, crackear.

Modo CLI

Escanear redes:

sudo autowifi scan -i wlan0mon -d 30

Capturar handshake WPA:

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

Crackear un archivo de captura:

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

Usar backend hashcat:

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

Vectores de Ataque

Configuración

La configuración se almacena en ~/.autowifi/config.json. Se puede editar a través del menú interactivo o directamente:

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

Estructura del Proyecto

autowifi/
  cli.py          - Punto de entrada, modo interactivo, comandos CLI
  ui.py           - Componentes de interfaz de terminal (basados en Rich)
  scanner.py      - Descubrimiento de redes y seguimiento de clientes
  attacks.py      - Implementaciones de ataques WEP, WPA, WPS, PMKID
  handshake.py    - Captura y verificación de handshake
  cracker.py      - Cracking de contraseñas con múltiples backends
  interface.py    - Gestión de interfaz inalámbrica
  session.py      - Persistencia de sesiones
  report.py       - Generación de informes HTML/JSON/texto
  config.py       - Gestión de configuración
  deps.py         - Comprobación de dependencias

Legal

Esta herramienta está destinada únicamente a pruebas de seguridad autorizadas y fines educativos. El acceso no autorizado a redes informáticas es ilegal. Obtenga siempre la autorización escrita adecuada antes de realizar pruebas.

Licencia

GPL-3.0