guardana/guardana

Что это?

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

• 01Офлайн-статическое сканирование кода и артефактов моделей, включая поиск небезопасного использования pickle и torch.load
• 02Активные проверки конечных точек LLM, серверов MCP и агентов A2A
• 03Анализ трасс OpenTelemetry GenAI и трасс в собственном формате
• 04Раздельная отчетность об обнаруженных проблемах, непроверенных пунктах, ошибках и пробелах в охвате проверками
• 05Вывод в форматах SARIF, JSON, JUnit и текстовом формате с документированными кодами завершения для CI
• 06Сравнение сохранённых проверок командой diff

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

• Блокировка CI-пайплайна при проверке файлов моделей, загруженных из Hub, перед развёртыванием
• Загрузка результатов SARIF в GitHub code scanning для репозитория приложения на базе LLM
• Запуск плановых активных проверок тестовой среды с LLM или сервером MCP
• Оценка ответов, уже записанных работающим приложением, без отправки новых запросов

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

1. 1

   Сканирование без установки с помощью uv

   uvx --from guardana-cli guardana scan .
2. 2

   Установите пакет с помощью uv

   uv add guardana-cli
3. 3

   Или установите пакет с помощью pip

   pip install guardana-cli
4. 4

   Создайте стартовый проект, чтобы попробовать первый запуск в офлайн-режиме

   guardana init --starter first-run

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

• !Бета-версия: поведение может измениться.
• !Активные проверки отправляют реальные запросы целевому ресурсу и могут повлечь расходы, поэтому сначала следует установить бюджет.
• !Это не встроенный механизм защиты, не универсальный SAST- или CVE-сканер и не сертификация соответствия требованиям.

Темы

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

Что такое guardana?

CLI и библиотека с открытым исходным кодом для проверки файлов моделей ИИ, кода, работающих конечных точек LLM/агентов/MCP и записанных трасс агентов с отчетом о проблемах и пробелах в проверках. Guardana — инструмент для проверки систем ИИ, предназначенный для инженеров по безопасности и платформенной инфраструктуре. Он офлайн сканирует код и артефакты моделей на наличие таких рисков, как небезопасная загрузка pickle, вызов torch.load без weights_only, удаленное выполнение кода в конфигурациях моделей и подозрительные импорты. Также он может активно проверять работающую конечную точку модели, сервер MCP или агента A2A, а ещё анализировать записанные трассы в формате OpenTelemetry GenAI или собственном формате проекта.

guardana можно использовать бесплатно? Какая у него лицензия?

guardana распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.

guardana всё ещё поддерживается?

Активно поддерживается. Последний коммит в guardana — 21 окт. 2026 г..

Для чего можно использовать guardana?

Блокировка CI-пайплайна при проверке файлов моделей, загруженных из Hub, перед развёртыванием Загрузка результатов SARIF в GitHub code scanning для репозитория приложения на базе LLM Запуск плановых активных проверок тестовой среды с LLM или сервером MCP Оценка ответов, уже записанных работающим приложением, без отправки новых запросов

Как установить guardana?

Сканирование без установки с помощью uv: uvx --from guardana-cli guardana scan . Установите пакет с помощью uv: uv add guardana-cli Или установите пакет с помощью pip: pip install guardana-cli Создайте стартовый проект, чтобы попробовать первый запуск в офлайн-режиме: guardana init --starter first-run

Где скачать guardana?

Исходный код и инструкции по установке — на GitHub: https://github.com/guardana/guardana