AutoWIFI

Framework de testes de penetração sem fio.
Automatiza toda a cadeia de ataque – do reconhecimento à exploração – com uma interface de terminal limpa.

Funcionalidades

• Ataques multi-vetor – WEP (replay ARP, fragmentação, chopchop), WPA/WPA2 (captura de handshake, PMKID), WPS (Pixie Dust, força bruta de PIN)
• Seleção inteligente de alvo – Recomenda automaticamente vetores de ataque com base na criptografia e configuração do alvo
• Varredura ao vivo – Descoberta de redes em tempo real com visualização da intensidade do sinal e rastreamento de clientes
• Múltiplos backends de cracking – aircrack-ng, hashcat (GPU), John the Ripper
• Gerenciamento de sessões – Salvar, restaurar e retomar operações interrompidas
• Geração de relatórios – Exportar resultados nos formatos HTML, JSON e texto
• Gerenciamento de interfaces – Modo monitor automático, randomização de MAC, controle de canal
• Verificação de handshake – Validação multimétodo de handshakes capturados
• Descoberta de wordlists – Detecta automaticamente wordlists instaladas (rockyou, seclists, etc.)

Requisitos

• Linux com um adaptador sem fio que suporte modo monitor
• Python 3.9+
• Suíte aircrack-ng (obrigatório)
• Opcionais: hashcat, reaver, bully, hcxdumptool, mdk4, macchanger

Instalação

Via PyPI (recomendado)

pip install autowifi

Instalar dependências do sistema

O framework utiliza a suíte aircrack-ng e ferramentas relacionadas. Instale-as para sua distribuição:

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

Apenas aircrack-ng é estritamente obrigatório. Os demais desbloqueiam vetores de ataque adicionais (WPS, PMKID, cracking via GPU, etc.).

A partir do código fonte

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

Desenvolvimento

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

Verificar instalação

sudo autowifi --version

Servidor MCP (Integração com Agentes de IA)

O AutoWIFI inclui um servidor MCP (Model Context Protocol), disponibilizando todas as ferramentas de teste de penetração sem fio para assistentes de IA de codificação como Claude Code, Codex, Gemini e Cursor.

Instalar com suporte a MCP

pip install autowifi[mcp]

Configurar para Claude Code

Adicione em ~/.claude/settings.json:

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

Configurar para Cursor

Adicione em .cursor/mcp.json:

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

Ferramentas MCP disponíveis

Agora seu agente de IA pode executar testes de penetração sem fio de forma autônoma.

Uso

Modo interativo

sudo autowifi

Inicia a TUI completa com fluxo orientado por menus – escaneie, selecione o alvo, ataque, quebre.

Modo CLI

Escaneie redes:

sudo autowifi scan -i wlan0mon -d 30

Capture handshake WPA:

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

Quebre um arquivo de captura:

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

Use o backend hashcat:

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

Vetores de Ataque

Configuração

As configurações são armazenadas em ~/.autowifi/config.json. Edite através do menu interativo ou diretamente:

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

Estrutura do Projeto

autowifi/
  cli.py          - Ponto de entrada, modo interativo, comandos CLI
  ui.py           - Componentes da interface de terminal (baseado em Rich)
  scanner.py      - Descoberta de redes e rastreamento de clientes
  attacks.py      - Implementações de ataques WEP, WPA, WPS, PMKID
  handshake.py    - Captura e verificação de handshake
  cracker.py      - Cracking de senhas com múltiplos backends
  interface.py    - Gerenciamento de interfaces sem fio
  session.py      - Persistência de sessão
  report.py       - Geração de relatórios HTML/JSON/texto
  config.py       - Gerenciamento de configuração
  deps.py         - Verificação de dependências

Legal

Esta ferramenta destina-se exclusivamente a testes de segurança autorizados e fins educacionais. O acesso não autorizado a redes de computadores é ilegal. Sempre obtenha a devida autorização por escrito antes de testar.

Licença

GPL-3.0