
DeepZero deepzero-v0.4.0
Trova zero-days mentre dormi. DeepZero è un framework automatizzato di ricerca delle vulnerabilità che effettua il parsing, decompila e analizza migliaia di driver del kernel Windows per IOCTL sfruttabili in modo nativo utilizzando agenti AI.
Motore di pipeline per la ricerca automatizzata di vulnerabilità
Definisci le pipeline in YAML, elabora i campioni in parallelo e riprendi le esecuzioni interrotte.
![]() |
![]() |
- Pipeline YAML - combina fasi di acquisizione, filtraggio, trasformazione e valutazione tramite LLM.
- Esecuzione parallela - imposta la concorrenza per ogni fase.
- Stato salvato - riprendi le esecuzioni interrotte dai risultati su disco.
- Riesecuzioni incrementali - le modifiche a prompt, regole o configurazione rieseguono la fase interessata e le fasi successive.
- Backend LLM - usa prompt Jinja2 con LiteLLM o la CLI di Claude Code.
- Report HTML - genera un report autonomo con
deepzero report. - Processori personalizzati - scrivi classi Python e referenziale tramite percorso in YAML.
- API REST sperimentale - interroga lo stato delle esecuzioni e i dati dei campioni via HTTP.
📚 Documentazione
Architettura, configurazione delle pipeline, riferimento CLI e processori personalizzati.
⚡️ Avvio rapido
Richiede Python 3.11+. La demo utilizza i file di testo inclusi e non richiede chiavi API né strumenti esterni.
git clone https://github.com/416rehman/DeepZero.git
cd DeepZero
python -m pip install -e .
deepzero run pipelines/demo/samples -p pipelines/demo/pipeline.yaml
deepzero report -p pipelines/demo/pipeline.yaml --open
Questi comandi funzionano in PowerShell e nelle shell POSIX. Per un'installazione isolata, creare e attivare un ambiente virtuale Python prima di installare.
La demo mantiene un file di testo, filtra quello più piccolo e genera un report. Ripetere il comando deepzero run per riprendere dallo stato salvato. Consultare la demo walkthrough per i risultati attesi e le opzioni di configurazione.
Configurazione della pipeline di sicurezza
Le due pipeline di sicurezza richiedono un corpus di destinazione proprio e strumenti aggiuntivi. Continuare dal repository clonato dopo la demo; queste integrazioni sono opzionali.
-
Installare le integrazioni opzionali
python -m pip install -e ".[full]"L'extra
fullinclude il parsing PE, LLM basati su API e il server API sperimentale. Il solo motore richiede unicamentepython -m pip install -e ..Esegui i comandi seguenti dal repository clonato. Entrambe le pipeline di sicurezza richiedono Semgrep nel PATH (
python -m pip install semgrep) e un backend LLM. L'audit del codice sorgente richiede anche Git. La pipeline del driver richiede Ghidra, il relativo JDK supportato eGHIDRA_INSTALL_DIRche punta alla tua installazione. Installa questi strumenti nell'ambiente in cui viene eseguito DeepZero; se utilizzi WSL, usa coerentemente il suo ambiente Linux. -
Configura l'ambiente
cp .env.example .envIn PowerShell, usa
Copy-Item .env.example .env. Imposta il tuo percorso di Ghidra in.envper l'analisi dei driver.
Entrambe le pipeline di sicurezza usano per impostazione predefinita claude-code, che utilizza il modello predefinito della tua CLI di Claude Code. Installa prima quella CLI e accedi con il tuo account. Per usare invece un modello basato su API, imposta la sua chiave API e DEEPZERO_MODEL in .env, oppure passa -m, ad esempio -m openai/gpt-4o.
-
Esegui una Pipeline
# kernel drivers on disk deepzero run ./drivers -p pipelines/loldrivers/pipeline.yaml --preflight # or source code, from a manifest of repositories or a directory of checkouts deepzero run repos.txt -p pipelines/source_audit/pipeline.yaml --preflightSostituisci
./driverscon il tuo corpus di driver, oppure crearepos.txtcon un URL di repository per riga per gli audit del codice sorgente. Questi sono input di esempio; nessuno dei due è incluso nel repository.Verifica i prerequisiti dello strumento e della pipeline prima di iniziare:
deepzero validate pipelines/loldrivers/pipeline.yaml(oppurepipelines/source_audit/pipeline.yaml).--preflightverifica il backend LLM prima che inizi l'elaborazione. -
Leggi i risultati
deepzero report -p loldrivers --openI report possono essere generati durante o dopo un'esecuzione.
deepzero runselenca le esecuzioni sottowork/, o un'altra directory passata con--work-dir. Senza argomenti,deepzero reportutilizza l'unica esecuzione presente sottowork/oppure ti chiede di sceglierne una se ne esistono diverse. Usa--work-dirper selezionare un'esecuzione negli script.
Per le pipeline di sicurezza, segui la guida completa alla configurazione e i prerequisiti delle pipeline. Le integrazioni opzionali richiedono le proprie dipendenze e configurazione.
Segnala bug o suggerisci modifiche nel tracker delle issue.
📁 Struttura del repository
src/deepzero/
├── cli.py # click command group (run, report, runs, status, validate, ...)
├── api/ # REST API (starlette)
├── engine/ # orchestration, state persistence, pipeline execution
└── stages/ # built-in processors (map, reduce, ingest)

