$ show 416rehman/DeepZero
DeepZero is an automated vulnerability research pipeline engine, primarily targeting Windows kernel driver (BYOVD) analysis. It provides a highly concurrent, resumable orchestration framework where pipelines are defined declaratively in YAML. The engine supports stages: ingest, map (parallel analysis), reduce (aggregation), and bulk_map, with built-in fault tolerance, atomic state persistence, and live progress dashboards. It integrates external tools like Ghidra (headless decompilation), Semgrep (static analysis), LIEF (PE parsing), and LLM backends (LiteLLM, Claude Code) for exploitability assessment. The repository includes a full reference pipeline (loldrivers) and multiple language documentation sites. While primarily an application framework, it has strong data research characteristics due to its focus on binary corpus analysis and heuristic/AI assessment.
The LLM identified 5 files worth highlighting for reuse:
StateStore implements atomic, per-sample state persistence using os.replace for safe file writes. Supports run manifests, per-sample state files (state.json), schema versioning, and sandboxed sample directories. The design is decoupled from pipeline internals and could be extracted for any batch processing system requiring robust, resumable state tracking.
Liveness detection module reliably determines if a run's owning process is still alive, handling PID reuse (via hostname and start token) and cross-platform differences. Self-contained logic that can be reused in any distributed or long-running job system to avoid false positives from PID reuse.
LLM backend abstraction layer with a registry pattern. Defines base classes (LLMBackend, CLIAgentBackend) and concrete implementations (LiteLLMBackend, ClaudeCodeBackend). Backends are registered by model scheme and can declare retry roles. This pattern is reusable for any system needing to support multiple AI provider APIs or agent CLIs.
Ghidra postScript for extracting IRP dispatch tables from Windows kernel drivers. Uses a two-phase search: first checks known dispatch functions (e.g., IofCompleteRequest, IoSkipCurrentIrpStackLocation) via priority callee list, then falls back to full function scan. Identifies device creation load path (on/off) to determine hardware dependence. This script demonstrates sophisticated Ghidra scripting and is reusable for any driver analysis pipeline.
Provides run_subprocess_with_kill for executing subprocesses with timeouts and proper process tree cleanup. Handles Windows (taskkill) and POSIX (SIGKILL) differently, and includes stdout/stderr capture. Self-contained utility reusable in any Python application that needs reliable subprocess execution with termination guarantees.