Zurück zu den Updates
New releaseAug 3, 2026

DeepZero deepzero-v0.4.0

Finde Zero-Days, während du schläfst. DeepZero ist ein automatisiertes Schwachstellenforschungs-Framework, das tausende Windows-Kernel-Treiber parst, dekompiliert und nativ mit KI-Agenten auf ausnutzbare IOCTLs analysiert.

Teilen

DeepZero

Engine für automatisierte Schwachstellenforschungs-Pipelines

Definiere Pipelines in YAML, verarbeite Samples parallel und setze unterbrochene Läufe fort.

CI License Docs Python Platform


DeepZero Terminal-Dashboard

DeepZero HTML-Bericht für ein Quellcode-Audit DeepZero HTML-Bericht für eine Kernel-Treiber-Prüfung
Beispielberichte mit Beispieldaten.

English | 简体中文 | Français

  • YAML-Pipelines – kombiniere Stufen für Ingestion, Filterung, Transformation und LLM-Bewertung.
  • Parallele Ausführung – lege die Parallelität pro Stufe fest.
  • Gespeicherter Zustand – setze unterbrochene Läufe aus den Ergebnissen auf der Festplatte fort.
  • Inkrementelle erneute Läufe – Änderungen an Prompts, Regeln oder Konfiguration führen die betroffene Stufe und nachgelagerte Stufen erneut aus.
  • LLM-Backends – verwende Jinja2-Prompts mit LiteLLM oder der Claude Code CLI.
  • HTML-Berichte – erstelle mit deepzero report einen eigenständigen Bericht.
  • Benutzerdefinierte Prozessoren – schreibe Python-Klassen und referenziere sie per Pfad in YAML.
  • Experimentelle REST-API – frage den Laufstatus und Beispieldaten über HTTP ab.

📚 Dokumentation

Architektur, Pipeline-Konfiguration, CLI-Referenz und benutzerdefinierte Prozessoren.


⚡️ Schnellstart

Erfordert Python 3.11+. Die Demo verwendet mitgelieferte Textdateien und benötigt keine API-Schlüssel oder externen Tools.

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

Diese Befehle funktionieren in PowerShell und POSIX-Shells. Für eine isolierte Installation erstellen und aktivieren Sie vor der Installation eine Python-virtuelle Umgebung.

Die Demo behält eine Textdatei, filtert die kleinere heraus und erzeugt einen Bericht. Wiederholen Sie den Befehl deepzero run, um vom gespeicherten Zustand aus fortzufahren. Die erwarteten Ergebnisse und Konfigurationsoptionen finden Sie in der Demo-Anleitung.

Einrichtung der Sicherheits-Pipeline

Die beiden Sicherheits-Pipelines benötigen Ihr eigenes Zielkorpus und zusätzliche Tools. Fahren Sie nach der Demo im geklonten Repository fort; diese Integrationen sind optional.

  1. Optionale Integrationen installieren

    python -m pip install -e ".[full]"
    

    Das full-Extra enthält PE-Parsing, API-gestützte LLMs und den experimentellen API-Server. Die Engine allein benötigt nur python -m pip install -e ..

    Führen Sie die folgenden Befehle aus dem geklonten Repository aus. Beide Sicherheits-Pipelines benötigen Semgrep im PATH (python -m pip install semgrep) und ein LLM-Backend. Der Quellcode-Audit benötigt außerdem Git. Die Driver-Pipeline benötigt Ghidra, das unterstützte JDK und GHIDRA_INSTALL_DIR, das auf Ihre Installation verweist. Installieren Sie diese Tools in der Umgebung, in der DeepZero ausgeführt wird; wenn Sie WSL verwenden, nutzen Sie dessen Linux-Umgebung durchgängig.

  2. Umgebung konfigurieren

    cp .env.example .env
    

    In PowerShell verwenden Sie Copy-Item .env.example .env. Legen Sie Ihren eigenen Ghidra-Pfad in .env für die Treiberanalyse fest.

Beide Sicherheits-Pipelines verwenden standardmäßig claude-code, das das Standardmodell Ihrer Claude Code CLI nutzt. Installieren Sie diese CLI und melden Sie sich zuerst mit Ihrem eigenen Konto an. Um stattdessen ein API-gestütztes Modell zu verwenden, legen Sie dessen API-Schlüssel und DEEPZERO_MODEL in .env fest oder übergeben Sie -m, zum Beispiel -m openai/gpt-4o.

  1. Eine Pipeline ausführen

    # 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 --preflight
    

    Ersetzen Sie ./drivers durch Ihren Treiber-Korpus oder erstellen Sie repos.txt mit einer Repository-URL pro Zeile für Quellcode-Audits. Dies sind Beispiel-Eingaben; keine von beiden ist im Repository enthalten.

    Prüfen Sie die Voraussetzungen für Tool und Pipeline, bevor Sie beginnen: deepzero validate pipelines/loldrivers/pipeline.yaml (oder pipelines/source_audit/pipeline.yaml). --preflight prüft das LLM-Backend, bevor die Verarbeitung beginnt.

  2. Die Ergebnisse lesen

    deepzero report -p loldrivers --open
    

    Berichte können während oder nach einem Lauf erstellt werden. deepzero runs listet Läufe unter work/ oder einem anderen Verzeichnis auf, das mit --work-dir übergeben wurde. Ohne Argumente verwendet deepzero report den einzigen Lauf unter work/ oder fordert Sie zur Auswahl auf, wenn mehrere vorhanden sind. Verwenden Sie --work-dir, um einen Lauf in Skripten auszuwählen.

Befolgen Sie für die Sicherheits-Pipelines die vollständige Einrichtungsanleitung und die Pipeline-Voraussetzungen. Optionale Integrationen erfordern ihre eigenen Abhängigkeiten und Konfigurationen.

Melden Sie Fehler oder schlagen Sie Änderungen im Issue-Tracker vor.


📁 Repository-Struktur

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)

Kategorien