Volver a actualizaciones
Nuevo releaseAug 3, 2026

DeepZero deepzero-v0.4.0

Encuentra vulnerabilidades de día cero mientras duermes. DeepZero es un marco automatizado de investigación de vulnerabilidades que analiza, descompila y evalúa miles de controladores de kernel de Windows en busca de IOCTLs explotables de forma nativa utilizando agentes de IA.

Compartir

DeepZero

Motor de canalizaciones automatizadas para investigación de vulnerabilidades

Define canalizaciones en YAML, procesa muestras en paralelo y reanuda ejecuciones interrumpidas.

CI License Docs Python Platform


Panel de terminal de DeepZero

Informe HTML de DeepZero para una auditoría de código fuente Informe HTML de DeepZero para una revisión de controladores del kernel
Informes de ejemplo con datos de muestra.

English | 简体中文 | Français

  • Canalizaciones YAML - combina etapas de ingesta, filtrado, transformación y evaluación con LLM.
  • Ejecución en paralelo - establece la concurrencia por etapa.
  • Estado guardado - reanuda ejecuciones interrumpidas a partir de los resultados en disco.
  • Reejecuciones incrementales - los cambios en prompts, reglas o configuración reejecutan la etapa afectada y las etapas posteriores.
  • Backends de LLM - usa prompts de Jinja2 con LiteLLM o la CLI de Claude Code.
  • Informes HTML - genera un informe autocontenido con deepzero report.
  • Procesadores personalizados - escribe clases de Python y referéncialas por ruta en YAML.
  • API REST experimental - consulta el estado de la ejecución y los datos de las muestras por HTTP.

📚 Documentación

Arquitectura, configuración de canalizaciones, referencia de la CLI y procesadores personalizados.


⚡️ Inicio rápido

Requiere Python 3.11+. La demostración usa archivos de texto incluidos y no necesita claves de API ni herramientas externas.

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

Estos comandos funcionan en PowerShell y en shells POSIX. Para una instalación aislada, cree y active un entorno virtual de Python antes de instalar.

La demo conserva un archivo de texto, filtra el más pequeño y genera un informe. Repita el comando deepzero run para reanudar desde el estado guardado. Consulte el recorrido de la demo para conocer los resultados esperados y las opciones de configuración.

Configuración del pipeline de seguridad

Los dos pipelines de seguridad necesitan su propio corpus objetivo y herramientas adicionales. Continúe desde el repositorio clonado después de la demo; estas integraciones son opcionales.

  1. Instalar integraciones opcionales

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

    El extra full incluye el análisis de PE, los LLM respaldados por API y el servidor API experimental. El motor por sí solo necesita únicamente python -m pip install -e ..

    Ejecute los comandos a continuación desde el repositorio clonado. Ambas canalizaciones de seguridad necesitan Semgrep en PATH (python -m pip install semgrep) y un backend de LLM. La auditoría de código fuente también necesita Git. La canalización del driver necesita Ghidra, su JDK compatible y GHIDRA_INSTALL_DIR apuntando a su instalación. Instale estas herramientas en el entorno donde se ejecuta DeepZero; si utiliza WSL, use su entorno Linux de forma consistente.

  2. Configurar el entorno

    cp .env.example .env
    

    En PowerShell, use Copy-Item .env.example .env. Configure su propia ruta de Ghidra en .env para el análisis de controladores.

Ambos pipelines de seguridad usan claude-code por defecto, que utiliza el modelo predeterminado de su Claude Code CLI. Instale ese CLI e inicie sesión con su propia cuenta primero. Para usar en su lugar un modelo respaldado por API, configure su clave de API y DEEPZERO_MODEL en .env, o pase -m, por ejemplo -m openai/gpt-4o.

  1. Ejecutar un 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 --preflight
    

    Reemplace ./drivers con su corpus de drivers, o cree repos.txt con una URL de repositorio por línea para auditorías de código fuente. Estas son entradas de ejemplo; ninguna está incluida en el repositorio.

    Verifique los requisitos previos de la herramienta y del pipeline antes de comenzar: deepzero validate pipelines/loldrivers/pipeline.yaml (o pipelines/source_audit/pipeline.yaml). --preflight verifica el backend del LLM antes de que comience el procesamiento.

  2. Leer los resultados

    deepzero report -p loldrivers --open
    

    Los informes se pueden generar durante o después de una ejecución. deepzero runs lista las ejecuciones bajo work/, o en otro directorio pasado con --work-dir. Sin argumentos, deepzero report usa la única ejecución bajo work/ o te solicita elegir si existen varias. Usa --work-dir para seleccionar una ejecución en scripts.

Para las canalizaciones de seguridad, sigue la guía de configuración completa y los requisitos previos de la canalización. Las integraciones opcionales requieren sus propias dependencias y configuración.

Informa de errores o sugiere cambios en el rastreador de incidencias.


📁 Estructura del repositorio

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)

Categorías