Repolode
Предложить
zakirkun

zakirkun/guardian-cli

Python CLI для оркестрации пентестов с помощью LLM, таких как Google Gemini, OpenAI и Claude, и проверенных инструментов безопасности вроде nmap и nuclei.

Открыть на GitHub
Звёзды
1,895
Форки
368
Открытые issues
5
Последний коммит
4 месяца назад

Что это?

Guardian — это CLI-фреймворк для автоматизации пентестов. AI-агент планирует этапы проверки, выбирает инструменты безопасности и анализирует их вывод. При этом выполнение каждого инструмента записывается, поэтому любую находку можно связать с командой, которая её обнаружила.

Поддерживается несколько AI-провайдеров: OpenAI, Claude, Gemini, OpenRouter, Requesty, Ollama и совместимые с OpenAI endpoints. В проект входит около 50 обёрток над инструментами для сканирования сети, веб-разведки, поиска поддоменов, сканирования уязвимостей, проверки SSL/TLS, аудита облачной инфраструктуры и контейнеров, а также проверки Active Directory и Android. Рабочие процессы описываются в YAML в виде графа зависимостей; этапы можно выполнять параллельно и возобновлять после прерывания.

Отчёты можно создавать в форматах Markdown, HTML и JSON, а находки экспортировать в SARIF, DefectDojo или Slack. В инструменте есть проверка области тестирования, подтверждение перед запуском инструментов, способных повлиять на систему, и маскировка API keys в логах. Guardian предназначен только для проверки систем, на тестирование которых у пользователя есть разрешение.

Ключевые возможности

  • 01Планирование проверок и выбор инструментов с помощью AI от разных провайдеров, включая Gemini, OpenAI, Claude и локальные модели Ollama.
  • 02Около 50 обёрток над инструментами для проверки сетей, веб-приложений, облачной инфраструктуры и мобильных устройств.
  • 03Рабочие процессы в YAML с параллельным выполнением на основе зависимостей и возможностью возобновления.
  • 04Сбор подтверждающих данных, связывающий каждую находку с запуском инструмента, в котором она была обнаружена.
  • 05Экспорт отчётов в Markdown, HTML, JSON и SARIF, а также интеграции с DefectDojo и Slack.
  • 06Проверка области тестирования и подтверждение перед запуском инструментов, способных повлиять на систему.

Сценарии использования

  • Проведение повторяемой разведки и сканирования веб-уязвимостей на системах, которые разрешено тестировать.
  • Подготовка структурированных отчётов о пентестах с подтверждающими данными и экспортом в системы учёта задач или инструменты анализа кода на основе SARIF.
  • Эксперименты с автоматизацией проверок безопасности на основе LLM с помощью локальной модели через Ollama.

Быстрый старт

  1. 1

    Клонируйте репозиторий

    git clone https://github.com/zakirkun/guardian-cli.git
  2. 2

    Перейдите в каталог проекта

    cd guardian-cli
  3. 3

    Создайте виртуальное окружение и выполните установку (Linux/macOS)

    python3 -m venv venv && source venv/bin/activate && pip install -e .
  4. 4

    Проверьте установку

    python -m cli.main --help

Что важно знать

  • Требуется API-ключ поддерживаемого поставщика ИИ, например OpenAI, Anthropic, Google, OpenRouter или Requesty.
  • Многие инструменты безопасности необязательны, и для полной функциональности их нужно устанавливать отдельно.
  • В метаданных указана лицензия NOASSERTION, хотя в README указана MIT; перед использованием проверьте файл LICENSE.
  • Инструмент предназначен только для авторизованного тестирования безопасности, поэтому за его использование несут юридическую ответственность.

Темы

#penetration-testing#security-automation#llm-agent#cli#gemini#vulnerability-scanning#automation#gemini-ai#generative-ai#pentest-tool

Частые вопросы

Что такое guardian-cli?
Python CLI для оркестрации пентестов с помощью LLM, таких как Google Gemini, OpenAI и Claude, и проверенных инструментов безопасности вроде nmap и nuclei. Guardian — это CLI-фреймворк для автоматизации пентестов. AI-агент планирует этапы проверки, выбирает инструменты безопасности и анализирует их вывод. При этом выполнение каждого инструмента записывается, поэтому любую находку можно связать с командой, которая её обнаружила.
guardian-cli можно использовать бесплатно? Какая у него лицензия?
guardian-cli распространяется с открытым исходным кодом под лицензией Other. Перед использованием в коммерческих продуктах проверьте условия лицензии.
guardian-cli всё ещё поддерживается?
Обновлялся за последние 6 месяцев. Последний коммит в guardian-cli — 27 июн. 2026 г..
Для чего можно использовать guardian-cli?
Проведение повторяемой разведки и сканирования веб-уязвимостей на системах, которые разрешено тестировать. Подготовка структурированных отчётов о пентестах с подтверждающими данными и экспортом в системы учёта задач или инструменты анализа кода на основе SARIF. Эксперименты с автоматизацией проверок безопасности на основе LLM с помощью локальной модели через Ollama.
Как установить guardian-cli?
Клонируйте репозиторий: git clone https://github.com/zakirkun/guardian-cli.git Перейдите в каталог проекта: cd guardian-cli Создайте виртуальное окружение и выполните установку (Linux/macOS): python3 -m venv venv && source venv/bin/activate && pip install -e . Проверьте установку: python -m cli.main --help
Где скачать guardian-cli?
Исходный код и инструкции по установке — на GitHub: https://github.com/zakirkun/guardian-cli

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты