
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.
Motor de canalizaciones automatizadas para investigación de vulnerabilidades
Define canalizaciones en YAML, procesa muestras en paralelo y reanuda ejecuciones interrumpidas.
![]() |
![]() |
- 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.
-
Instalar integraciones opcionales
python -m pip install -e ".[full]"El extra
fullincluye el análisis de PE, los LLM respaldados por API y el servidor API experimental. El motor por sí solo necesita únicamentepython -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 yGHIDRA_INSTALL_DIRapuntando a su instalación. Instale estas herramientas en el entorno donde se ejecuta DeepZero; si utiliza WSL, use su entorno Linux de forma consistente. -
Configurar el entorno
cp .env.example .envEn PowerShell, use
Copy-Item .env.example .env. Configure su propia ruta de Ghidra en.envpara 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.
-
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 --preflightReemplace
./driverscon su corpus de drivers, o creerepos.txtcon 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(opipelines/source_audit/pipeline.yaml).--preflightverifica el backend del LLM antes de que comience el procesamiento. -
Leer los resultados
deepzero report -p loldrivers --openLos informes se pueden generar durante o después de una ejecución.
deepzero runslista las ejecuciones bajowork/, o en otro directorio pasado con--work-dir. Sin argumentos,deepzero reportusa la única ejecución bajowork/o te solicita elegir si existen varias. Usa--work-dirpara 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)

