DeepZero  by 416rehman

AI-powered vulnerability research framework

Created 1 month ago
471 stars

Top 64.1% on SourcePulse

GitHubView on GitHub
Project Summary

Automated vulnerability research for Windows kernel drivers is addressed by DeepZero, an AI-powered framework. It enables users to efficiently discover zero-day vulnerabilities by parsing, decompiling, and analyzing driver binaries. This tool streamlines the complex process of vulnerability research, making it more scalable and accessible for security engineers and researchers.

How It Works

DeepZero employs a Pipeline-as-YAML engine for declaratively defining multi-stage analysis workflows, encompassing ingestion, filtering, transformation, and LLM-based assessment. It manages orchestration, parallelism via ThreadPoolExecutor with configurable concurrency, fault tolerance, and state persistence for resumable runs. The framework is extensible, supporting custom processors implemented as Python classes, and integrates with LLMs through Jinja2 prompt templates via LiteLLM.

Quick Start & Requirements

  • Installation: Clone the repository, navigate to the directory, and install using pip install -e ..
  • Prerequisites: Python 3.11+ is required. Users need a corpus of target files (e.g., Windows kernel drivers) and a pipeline configuration file (YAML).
  • Running: Execute pipelines with deepzero run <path_to_drivers> -p <path_to_pipeline.yaml>.

Highlighted Details

  • Pipeline-as-YAML: Declarative definition of complex analysis workflows.
  • Parallel Execution: Configurable concurrency per stage using ThreadPoolExecutor.
  • Resumable Runs: Atomic per-sample state persistence allows interrupted analyses to be resumed.
  • LLM Integration: Supports Jinja2 prompt templates with any LLM provider via LiteLLM.
  • Extensibility: Custom processors can be written as Python classes and referenced in YAML.

Maintenance & Community

  • Continuous Integration (CI) runs on Python 3.11 and 3.12 via GitHub Actions.
  • Pre-commit checks include linting (ruff) and security scanning (bandit).
  • No community channels (e.g., Discord, Slack) or specific contributor highlights are mentioned in the provided text.

Licensing & Compatibility

  • License: MIT License.
  • Compatibility: The MIT license is permissive, generally allowing commercial use and integration with closed-source projects.

Limitations & Caveats

  • The REST API is currently under development (WIP) and is experimental and incomplete.
  • Setup requires a specific corpus of target files and a correctly configured pipeline YAML.
Health Check
Last Commit

4 weeks ago

Responsiveness

Inactive

Pull Requests (30d)
4
Issues (30d)
0
Star History
160 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.