
DeepZero deepzero-v0.4.0
Encontre vulnerabilidades de dia zero enquanto você dorme. DeepZero é um framework automatizado de pesquisa de vulnerabilidades que analisa, descompila e examina milhares de drivers do kernel do Windows em busca de IOCTLs exploráveis, nativamente usando agentes de IA.
Mecanismo de pipeline automatizado para pesquisa de vulnerabilidades
Defina pipelines em YAML, processe amostras em paralelo e retome execuções interrompidas.
![]() |
![]() |
- Pipelines em YAML - combine etapas de ingestão, filtragem, transformação e avaliação por LLM.
- Execução paralela - defina a concorrência por etapa.
- Estado salvo - retome execuções interrompidas a partir dos resultados em disco.
- Reexecuções incrementais - alterações em prompts, regras ou configuração reexecutam a etapa afetada e as etapas seguintes.
- Backends de LLM - use prompts Jinja2 com LiteLLM ou a CLI do Claude Code.
- Relatórios HTML - gere um relatório autocontido com
deepzero report. - Processadores personalizados - escreva classes Python e referencie-as por caminho no YAML.
- API REST experimental - consulte o estado da execução e os dados das amostras via HTTP.
📚 Documentação
Arquitetura, configuração de pipeline, referência da CLI e processadores personalizados.
⚡️ Início rápido
Requer Python 3.11+. A demonstração usa arquivos de texto incluídos e não precisa de chaves de API nem de ferramentas 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
Esses comandos funcionam no PowerShell e em shells POSIX. Para uma instalação isolada, crie e ative um ambiente virtual Python antes de instalar.
A demonstração mantém um arquivo de texto, filtra o menor e gera um relatório. Repita o comando deepzero run para retomar a partir do estado salvo. Consulte o passo a passo da demonstração para os resultados esperados e as opções de configuração.
Configuração do Pipeline de Segurança
Os dois pipelines de segurança precisam do seu próprio corpus de destino e de ferramentas adicionais. Continue a partir do repositório clonado após a demonstração; essas integrações são opcionais.
-
Instalar Integrações Opcionais
python -m pip install -e ".[full]"O extra
fullinclui análise de PE, LLMs com suporte de API e o servidor de API experimental. O motor sozinho requer apenaspython -m pip install -e ..Execute os comandos abaixo a partir do repositório clonado. Ambos os pipelines de segurança precisam do Semgrep no PATH (
python -m pip install semgrep) e de um backend de LLM. A auditoria de código-fonte também precisa do Git. O pipeline de driver precisa do Ghidra, do seu JDK suportado e deGHIDRA_INSTALL_DIRapontando para a sua instalação. Instale estas ferramentas no ambiente onde o DeepZero é executado; se estiver usando WSL, use o seu ambiente Linux de forma consistente. -
Configurar o Ambiente
cp .env.example .envNo PowerShell, use
Copy-Item .env.example .env. Defina seu próprio caminho do Ghidra no.envpara análise de drivers.Ambos os pipelines de segurança usam
claude-codepor padrão, que utiliza o modelo padrão do seu Claude Code CLI. Instale esse CLI e faça login com sua própria conta primeiro. Para usar um modelo baseado em API, defina sua chave de API eDEEPZERO_MODELno.env, ou passe-m, por exemplo-m openai/gpt-4o. -
Executar um 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 --preflightSubstitua
./driverspelo seu corpus de drivers, ou crierepos.txtcom uma URL de repositório por linha para auditorias de código-fonte. Estes são exemplos de entradas; nenhum deles está incluído no repositório.Verifique os pré-requisitos da ferramenta e do pipeline antes de começar:
deepzero validate pipelines/loldrivers/pipeline.yaml(oupipelines/source_audit/pipeline.yaml).--preflightverifica o backend LLM antes de o processamento começar. -
Leia os Resultados
deepzero report -p loldrivers --openOs relatórios podem ser gerados durante ou após uma execução.
deepzero runslista as execuções emwork/, ou em outro diretório passado com--work-dir. Sem argumentos,deepzero reportusa a única execução emwork/ou solicita que você escolha caso existam várias. Use--work-dirpara selecionar uma execução em scripts.
Para os pipelines de segurança, siga o guia de configuração completo e os pré-requisitos do pipeline. As integrações opcionais exigem suas próprias dependências e configuração.
Relate bugs ou sugira alterações no rastreador de issues.
📁 Estrutura do Repositório
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)
processors/ # external processors (shipped as examples)
├── ghidra_decompile/ # ghidra headless decompiler (MapProcessor)
├── git_ingest/ # git repository discovery and cloning (IngestProcessor)
├── loldrivers_filter/ # loldrivers.io hash exclusion filter (MapProcessor)
├── pe_ingest/ # PE header parser and driver metadata extractor (IngestProcessor)
└── semgrep_scanner/ # semgrep batch scanner (BulkMapProcessor)

