Skip to content

Repository files navigation


SpiderPi 🕷️ v2.2.0 — Antigravity 2.1

Plataforma de reconhecimento automatizada com análise via Gemini 3.5 Flash Para Raspberry Pi Zero 2W com display Waveshare e-paper


Estrutura do Projeto

spiderpi/
├── web/                # Interface Web (Flask/Dashboard)
│   ├── app.py          # Backend do dashboard
│   ├── static/         # CSS e assets web
│   └── templates/      # Templates HTML
├── scanner.py          # Script principal — menu e integração Antigravity
├── epaper_display.py   # Driver do display Waveshare (v2.0)
├── setup.sh            # Instalação automatizada
├── KALI_INSTALL.md     # Guia de instalação do Kali Linux (Headless)
├── USAGE.md            # Guia de uso detalhado (CLI + Web)
├── CHANGELOG.md        # Histórico de versões e Release Notes
├── logs/               # JSONs com histórico de scans
└── README.md

📚 Documentação Detalhada

Para facilitar a navegação, o projeto está dividido nos seguintes guias:

  1. Guia de Instalação: Como preparar o Raspberry Pi Zero 2W com Kali Linux Headless.
  2. Guia de Uso: Detalhes sobre os comandos CLI, flags de automação e o Dashboard Web.

🛠️ Instalação Rápida

# 1. Clone ou copie os arquivos para o Pi
scp -r spiderpi/ pi@raspberrypi.local:~/

# 2. No Pi, execute o setup (requer root)
ssh pi@raspberrypi.local
cd ~/spiderpi
chmod +x setup.sh
sudo ./setup.sh

# O setup.sh criará um ambiente virtual (venv) e instalará o SDK 'google-genai'.
# Também será criado um alias 'spiderpi' para facilitar o acesso e um serviço systemd
# para mostrar uma tela de boot no e-paper.

# 3. Configure a API Key (Plataforma Antigravity / Google AI Studio)
# Durante o setup.sh, você será solicitado a inserir sua chave.
# Caso queira configurar manualmente depois:
echo 'export GEMINI_API_KEY="sua_chave_aqui"' >> ~/.zshrc
source ~/.zshrc

🖥️ Interface Web (Dashboard)

O SpiderPi possui um painel de controle que inicia automaticamente em background:

  • Monitoramento em Tempo Real: Veja o progresso dos scans linha por linha via Live Terminal Feed.
  • Análise Inteligente: Visualize as vulnerabilidades encontradas pela IA Antigravity 2.1.
  • Estatísticas: Acompanhe CPU, Temperatura e RAM do dispositivo em tempo real.
  • Acesse: http://raspberrypi.local:5000 (ou o IP do seu dispositivo)


🕹️ Modos de Uso

O SpiderPi suporta operação híbrida total:

  1. Modo Interativo (Menu): sudo -E spiderpi
  2. Modo Direto (Flags): sudo -E spiderpi --tool nmap --target 192.168.1.1
  3. Dashboard Web: Inicie scans remotamente pelo navegador.

⚠️ Aviso Legal

Esta ferramenta é destinada exclusivamente para fins educacionais e testes de penetração autorizados. O uso em redes sem permissão é ilegal.

About

SpiderPi é uma plataforma portátil de recon e análise de vulnerabilidades com IA para Raspberry Pi Zero 2W..

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages