
DeepZero deepzero-v0.4.0
Находите zero-days, пока спите. DeepZero — это автоматизированная платформа исследования уязвимостей, которая парсит, декомпилирует и анализирует тысячи драйверов ядра Windows на наличие эксплуатируемых IOCTL с использованием AI-агентов нативно.
Движок конвейера для автоматизированного исследования уязвимостей
Определяйте конвейеры в YAML, обрабатывайте образцы параллельно и возобновляйте прерванные запуски.
![]() |
![]() |
- Конвейеры YAML — объединяйте этапы приёма, фильтрации, преобразования и оценки с помощью LLM.
- Параллельное выполнение — задавайте уровень параллелизма для каждого этапа.
- Сохранение состояния — возобновляйте прерванные запуски по результатам на диске.
- Инкрементальные повторные запуски — изменения промптов, правил или конфигурации приводят к повторному запуску затронутого этапа и последующих этапов.
- Бэкенды LLM — используйте промпты Jinja2 с LiteLLM или Claude Code CLI.
- HTML-отчёты — создавайте автономный отчёт с помощью
deepzero report. - Пользовательские процессоры — пишите классы Python и ссылайтесь на них по пути в YAML.
- Экспериментальный REST API — запрашивайте состояние запуска и данные образцов по HTTP.
📚 Документация
Архитектура, конфигурация конвейера, справочник CLI и пользовательские процессоры.
⚡️ Быстрый старт
Требуется Python 3.11+. Демонстрация использует включённые текстовые файлы и не требует API-ключей или внешних инструментов.
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
Эти команды работают в PowerShell и POSIX-оболочках. Для изолированной установки создайте и активируйте виртуальное окружение Python перед установкой.
Демо сохраняет один текстовый файл, отфильтровывает меньший из них и генерирует отчёт. Повторите команду deepzero run, чтобы возобновить работу с сохранённого состояния. Ожидаемые результаты и параметры конфигурации см. в пошаговом руководстве по демо.
Настройка конвейера безопасности
Двум конвейерам безопасности требуются собственный целевой корпус и дополнительные инструменты. Продолжите работу из клонированного репозитория после демо; эти интеграции необязательны.
-
Установите дополнительные интеграции
python -m pip install -e ".[full]"Дополнительный пакет
fullвключает разбор PE, LLM с поддержкой API и экспериментальный API-сервер. Самому движку достаточно толькоpython -m pip install -e ..
Выполняйте приведённые ниже команды из клонированного репозитория. Обоим конвейерам безопасности нужен Semgrep в PATH (python -m pip install semgrep) и бэкенд LLM. Аудиту исходного кода также нужен Git. Конвейеру драйверов нужны Ghidra, поддерживаемая ею JDK и переменная GHIDRA_INSTALL_DIR, указывающая на вашу установку. Устанавливайте эти инструменты в той среде, где работает DeepZero; при использовании WSL последовательно используйте её окружение Linux.
- Настройка окружения
В PowerShell используйтеcp .env.example .envCopy-Item .env.example .env. Укажите свой путь к Ghidra в.envдля анализа драйверов.
Оба конвейера безопасности по умолчанию используют claude-code, который задействует модель по умолчанию вашего Claude Code CLI. Сначала установите этот CLI и войдите в свой аккаунт. Чтобы вместо этого использовать модель на основе API, задайте её API-ключ и DEEPZERO_MODEL в .env или передайте -m, например -m openai/gpt-4o.
-
Запуск конвейера
# 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Замените
./driversна ваш корпус драйверов или создайтеrepos.txtс одним URL репозитория на строку для аудита исходного кода. Это примеры входных данных; ни один из них не включён в репозиторий.Проверьте предварительные требования инструмента и конвейера перед началом:
deepzero validate pipelines/loldrivers/pipeline.yaml(илиpipelines/source_audit/pipeline.yaml).--preflightпроверяет бэкенд LLM перед началом обработки. -
Чтение результатов
deepzero report -p loldrivers --openОтчёты можно создавать во время или после запуска.
deepzero runsвыводит список запусков вwork/или в другой директории, указанной с помощью--work-dir. Без аргументовdeepzero reportиспользует единственный запуск вwork/или предлагает выбрать, если их несколько. Используйте--work-dirдля выбора запуска в скриптах.
Для конвейеров безопасности следуйте полному руководству по настройке и предварительным требованиям конвейера. Дополнительные интеграции требуют собственных зависимостей и конфигурации.
Сообщайте об ошибках или предлагайте изменения в трекере задач.
📁 Структура репозитория
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)

