____         ____                       ____  _
    / __ \  ___  / __/___   ___   ___  ___  / ___|| | __ _ __      __
   / / / / / _ \/ /_// _ \ / _ \ / __|/ _ \| |    | |/ _` |\ \ /\ / /
  / /_/ / /  __/ __//  __/| | | |\__ \  __/| |___ | | (_| | \ V  V /
 /_____/  \___/_/   \___/ |_| |_||___/\___| \____||_|\__,_|  \_/\_/

DefenseClaw объединяет операторский CLI на Python, шлюз на Go, хуки коннекторов, политики, сканеры и экспортёры наблюдаемости. Это слой принудительного применения и доказательств; он не доказывает, что агент, взаимодействие с моделью или сторонняя возможность безопасны.

Документация

Сайт документации DefenseClaw является источником истины по установке, настройке, конфигурации, командам и операторским рабочим процессам:

Markdown в репозитории ограничен руководством для контрибьюторов, контрактами реализации, локальными заметками пакетов, сгенерированными справочниками схем, тестовыми фикстурами и историческими записями о дизайне. Начните с docs/README.md.

Разработка из исходников

Цели сборки из исходников — это инструменты для контрибьюторов. Они не являются путём установки или обновления для хоста, управляемого релизами; для этих задач используйте руководства на сайте выше. Зафиксированные в репозитории контракты инструментария — это Python >=3.10,<3.14 (pyproject.toml) и Go 1.26.4 (go.mod). CI проверяет компоненты на TypeScript с помощью Node.js 24.

git clone https://github.com/cisco-ai-defense/defenseclaw.git
cd defenseclaw
make build
make test
make check
make lint

make build создаёт артефакты в рабочей копии, не публикуя их и не изменяя состояние управляемой установки; его шаг pycli может создать или обновить общий локальный для репозитория .venv. Перед использованием целей сборки, изменяющих состояние, запустите make help. Все локальные цели сборки из исходников используют один и тот же зафиксированный, готовый к тестированию .venv; отдельного Python-окружения для продакшена и разработки, которое можно было бы выбрать, нет. make test, make check и make py-lint при необходимости инициализируют это окружение. make all намеренно пересобирает и активирует текущую рабочую копию для локальной разработки; цели более низкого уровня make install, make dev-install и scripts/install-dev.sh обеспечивают соблюдение правил владения исходниками и не являются путём обновления. Релизные установки обновляются с помощью defenseclaw upgrade, который запускает установщик последнего релиза; см. страницу обновления.

Основные области исходного кода:

См. CONTRIBUTING.md для рабочего процесса pull-request и SECURITY.md для приватного сообщения об уязвимостях.

Лицензия

Apache-2.0. См. LICENSE и NOTICE.

Copyright 2026 Cisco Systems, Inc. и её аффилированные лица.