Автономный LLM-агент для red team, который планирует и выполняет полные цепочки атак — разведку, эксплуатацию, повышение привилегий, боковое перемещение и C2 — внутри изолированной песочницы Kali.
Популярное

Смотреть все →
Откройте для себя самые используемые инструменты нашего сообщества.
Изучить все инструменты
Просмотрите нашу коллекцию инструментов
Смотреть все инструменты →
[![English](https://img.shields.io/badge/Language-English-blue?style=for-the-badge)](README.md)
[![한국어](https://img.shields.io/badge/Language-%ED%95%9C%EA%B5%AD%EC%96%B4-red?style=for-the-badge)](README_KO.md)

<div align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/57385/c84f728f1380ceaf71e5368f94ae06af131fc7a6572dea112f43e7a0664b4439/ca68f6c32104ce0283c07aa0dc15516e8ce9b814807ca9a5b658185c0be24ed8-display-v1.webp" alt="Логотип Decepticon">
</div>

<h1 align="center">Decepticon — автономный агент Red Team</h1>

<p align="center"><i>«Очередной ИИ-хакер? Дайте угадаем — он запускает nmap и пишет отчёт».</i></p>

<div align="center">

<a href="https://trendshift.io/repositories/15987?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-15987" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/15987" alt="BitterSecurity%2FDecepticon | Trendshift" width="250" height="55"/></a>
<a href="https://trendshift.io/repositories/15987?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-15987" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/15987/daily?language=Python" alt="BitterSecurity%2FDecepticon | Trendshift" width="250" height="55"/></a>

<br/>

<a href="https://github.com/BitterSecurity/Decepticon/blob/main/LICENSE">
  <img src="https://img.shields.io/github/license/BitterSecurity/Decepticon?style=for-the-badge&amp;color=blue" alt="Лицензия: Apache 2.0">
</a>
<a href="https://github.com/BitterSecurity/Decepticon/stargazers">
  <img src="https://img.shields.io/github/stars/BitterSecurity/Decepticon?style=for-the-badge&amp;color=yellow" alt="Звёзды">
</a>
<a href="https://github.com/BitterSecurity/Decepticon/graphs/contributors">
  <img src="https://img.shields.io/github/contributors/BitterSecurity/Decepticon?style=for-the-badge&amp;color=orange" alt="Участники">
</a>

<br/>

<a href="https://discord.gg/TZUYsZgrRG">
  <img src="https://img.shields.io/badge/Discord-Join%20Us-7289DA?logo=discord&amp;logoColor=white&amp;style=for-the-badge" alt="Присоединяйтесь к нам в Discord">
</a>
<a href="https://decepticon.red">
  <img src="https://img.shields.io/badge/Website-decepticon.red-brightgreen?logo=vercel&amp;logoColor=white&amp;style=for-the-badge" alt="Веб-сайт">
</a>
<a href="https://docs.decepticon.red">
  <img src="https://img.shields.io/badge/Docs-docs.decepticon.red-8B5CF6?logo=bookstack&amp;logoColor=white&amp;style=for-the-badge" alt="Документация">
</a>
<a href="https://app.decepticon.red">
  <img src="https://img.shields.io/badge/Live%20App-app.decepticon.red-FF2D55?logo=rocket&amp;logoColor=white&amp;style=for-the-badge" alt="Работающее приложение">
</a>

</div>

<br/>

<div align="center">
  <p><strong>Демонстрация коммерческого продукта</strong></p>
  <video src="https://github.com/user-attachments/assets/7a9b233c-fd72-4633-a408-03953c345a15" width="800" controls></video>
</div>


<div align="center">

### ☁️ Не хотите разворачивать самостоятельно? **Decepticon уже работает в облаке.**

Пропустите настройку Docker — запускайте автономные red-team проекты прямо из браузера.

<a href="https://app.decepticon.red">
  <img src="https://img.shields.io/badge/Launch%20the%20Live%20App-app.decepticon.red-FF2D55?logo=rocket&amp;logoColor=white&amp;style=for-the-badge" alt="Запустить работающее приложение на app.decepticon.red">
</a>

</div>

<div align="center">
  <p><strong>Демонстрация CLI с открытым исходным кодом</strong></p>
  <video src="https://github.com/user-attachments/assets/b3fd40d8-e859-4a39-97f4-bd825694ad96" width="800" controls></video>
</div>

---

## Установка

**Требования**: [Docker](https://docs.docker.com/get-docker/) и Docker Compose v2.
Поддерживается на macOS (Apple Silicon + Intel), Linux (amd64 + arm64) и Windows (amd64 + arm64) — нативно через PowerShell или через WSL2 (Ubuntu / Kali).

**macOS / Linux / WSL2**
```bash
curl -fsSL https://decepticon.red/install | bash
decepticon onboard   # Interactive setup wizard (provider, API key, model profile)
decepticon           # Start the core stack and drop into the terminal CLI
```

Стандартный запуск поднимает базовую плоскость управления (LiteLLM, PostgreSQL, Neo4j, Skillogy, LangGraph, sandbox) и запускает терминальный CLI. Специализированные рабочие нагрузки (BloodHound CE, Sliver C2, REA/Ghidra, …) и веб-панель запускаются по требованию — оркестратор порождает специалистов через `ops_start("ad")` и т. п., а веб-панель вы поднимаете изнутри CLI командой `/web` (см. [Web Dashboard](https://github.com/bittersecurity/decepticon/blob/main/docs/web-dashboard.md)).

**Windows (PowerShell, нативно)**
```powershell
irm https://decepticon.red/install.ps1 | iex
decepticon onboard
decepticon
```

→ **[Быстрый старт](https://github.com/bittersecurity/decepticon/blob/main/docs/getting-started.md)** · **[Полное руководство по настройке](https://github.com/bittersecurity/decepticon/blob/main/docs/setup-guide.md)**

### Внутри интерактивного CLI

Введите `/`, чтобы просмотреть команды, выберите с помощью стрелок вверх/вниз, затем нажмите Enter. Tab дополняет
выбранную команду; псевдонимы также отображаются в справке и автодополнении.

| Команда | Назначение |
|---------|-----|
| `/help`, `/shortcuts` | Просмотр команд или сочетаний клавиш |
| `/model`, `/status` | Выбор настроенной модели или просмотр подключений сессии |
| `/plan` | Вход в необязательный режим Plan, затем отправьте ваше сообщение для планирования |
| `/mode red`, `/mode blue` | Возврат в Red или выбор расследования Blue |
| `/new` | Начать новый диалог в том же engagement и режиме, когда система простаивает |
| `/sessions`, `/resume` | Просмотр сохранённых диалогов или продолжение приостановленной работы |
| `/version` (`/about`), `/pwd` (`/cwd`) | Проверка текущей версии и путей рабочей области |
| `/quit`, `/exit` | Выход из чата; сервисы и работа сервера продолжают выполняться |

Enter отправляет; Shift+Enter, Alt+Enter или Ctrl+J добавляет строку. Стрелки вверх/вниз вызывают историю
ввода в первой/последней строке ввода; Ctrl+R ищет по ней. Esc сначала закрывает активный UI,
затем приостанавливает активную работу; `/resume` продолжает её. Ctrl+A перемещает в начало
текущей строки. Используйте `/queue`, чтобы просмотреть ожидающие сообщения перед `/new`.

`/new` сохраняет сохранённые диалоги и историю прокрутки терминала; он не создаёт
новый engagement и не изменяет авторизацию цели. `/plan` и `/new` не принимают
аргументов. В веб-терминале используйте элементы управления режимом на панели управления.

Новые сочетания клавиш и удобства со слэшем, описанные выше, относятся к текущей ветке `main`, включая
невыпущенные изменения. Слияние исходного кода не обновляет установленные образы. См.
[историю версий](https://github.com/bittersecurity/decepticon/blob/main/CHAGELOG.md), [полный справочник CLI](https://github.com/bittersecurity/decepticon/blob/main/docs/cli-reference.md#slash-commands)
и [поведение при обновлении](https://github.com/bittersecurity/decepticon/blob/main/docs/cli-experience.md#upgrade-behavior).

### Использование из Claude Code или Codex

После запуска Decepticon зарегистрируйте его MCP-сервер в вашем кодирующем агенте:

```bash
claude mcp add --scope user decepticon -- decepticon mcp serve
codex mcp add decepticon -- decepticon mcp serve
```

Используйте команду для установленного у вас агента программирования, затем выполните
`decepticon skill install`, чтобы добавить руководство оператора в оба агента. См.
[руководство по внешним агентам](https://github.com/bittersecurity/decepticon/blob/main/docs/integrations/external-agents.md) для Agent Skill,
рабочего процесса инструментов и пути установки из исходников.

### Использование в качестве библиотеки (pip)

Создаёте что-то поверх агентов — продукт, исследовательскую интеграцию или собственный оркестратор? Установите SDK из PyPI:

```bash
pip install decepticon              # core SDK
pip install "decepticon[neo4j]"     # + the knowledge-graph attack-chain tools
```

`decepticon` — это **клиентский SDK**: он поставляет фабрики агентов, middleware, инструменты и навыки, а также маршрутизирует вызовы LLM и выполнение в песочнице к runtime-сервисам по HTTP (`DECEPTICON_LLM__PROXY_URL`, `SANDBOX_URL`). Для запуска агентов всё ещё нужны эти сервисы — используйте стек Docker выше или укажите URL-адреса на собственные аналоги. См. **[Decepticon как библиотека](https://github.com/bittersecurity/decepticon/blob/main/docs/library-usage.md)** — там описаны поверхность переопределения фабрик, декларативные плагины `PluginBundle` и механизм проверки безопасности.

---

## 💖 Поддержать Decepticon

[![Sponsor](https://img.shields.io/badge/Sponsor-Decepticon-red?style=for-the-badge&logo=github)](https://github.com/sponsors/PurpleCHOIms)

Мы развиваем Decepticon в направлении **Offensive Vaccine** для ландшафта угроз, управляемого ИИ. Если вы верите в автономный red teaming как путь к более сильной защите, рассмотрите возможность поддержать проект.

---

## Бенчмарк

<div align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/57385/79abf1929da418d23947d8b49eb683ca3e052901d3ef0bec96b4a80628bd3618/d442be9566c8c2582382241af1924ecd058fb5b963074d7150d86b4b2c10e57d-display-v1.webp" alt="Decepticon — XBOW pass rate 102/104 (98.08%)" width="560">
</div>

| Бенчмарк | Сложность | Доля прохождений |
|-----------|------------|-----------|
| [XBOW validation-benchmarks](https://github.com/BitterSecurity/xbow-validation-benchmarks) | Лёгкая (уровень 1)   | **45 / 45** (100 %) |
| [XBOW validation-benchmarks](https://github.com/BitterSecurity/xbow-validation-benchmarks) | Средняя (уровень 2) | **50 / 51** (98.0 %) |
| [XBOW validation-benchmarks](https://github.com/BitterSecurity/xbow-validation-benchmarks) | Сложная (уровень 3)   | **7 / 8** (87.5 %) |
| [XBOW validation-benchmarks](https://github.com/BitterSecurity/xbow-validation-benchmarks) | **Все уровни**   | **102 / 104** (98.08 %) |

- **[Полный индекс по каждому испытанию, матрица классов атак и трассировки LangSmith](https://github.com/bittersecurity/decepticon/blob/main/benchmark/results/README.md)**
- **[Сравнение с другими ИИ-агентами для пентеста (Strix, PentestGPT, MAPTA, Cyber-AutoAgent, коммерческий XBOW, …)](https://github.com/bittersecurity/decepticon/blob/main/docs/benchmark-comparison.md)**

---

## Что такое Decepticon?

Пространство «ИИ + хакинг» полно демонстраций, которые запускают nmap и печатают отчёт. Это не про нас.

**Decepticon — профессиональный автономный агент Red Team.** Он выполняет реалистичные цепочки атак — разведку, эксплуатацию, повышение привилегий, боковое перемещение, C2 — так, как это делал бы настоящий противник, а не сканер.

Каждое Red-взаимодействие начинается с одобренной оператором цели и RoE. Опциональный режим Plan добавляет обсуждение Soundwave и семь планировочных документов вместе с доступным только для чтения RoE. Оркестратор выполнения владеет OPPLAN; Plan не обязателен для Red.

→ **[Подробный разбор рабочего процесса взаимодействия](https://github.com/bittersecurity/decepticon/blob/main/docs/engagement-workflow.md)**

---

## Почему Decepticon?

**Настоящие kill chain, а не сканирование по чек-листу.** Decepticon читает OPPLAN и добивается целей любым открывающимся путём — пивотинг, адаптация, связывание техник.

**Интерактивные оболочки — по-настоящему.** Настоящие наступательные инструменты интерактивны (`msfconsole`, `sliver-client`, `evil-winrm`). Decepticon выполняет каждую команду внутри постоянных сессий tmux с автоматическим распознаванием приглашения — поэтому, когда инструмент переходит в интерактивное приглашение, агент отправляет последующие команды без обходных путей.

**Усиленная изоляция песочницы.** Все команды выполняются внутри песочницы Kali Linux в выделенной операционной сети (`sandbox-net`), отдельной от плоскости управления (`decepticon-net`). LangGraph управляет песочницей через сокет Docker. → **[Архитектура](https://github.com/bittersecurity/decepticon/blob/main/docs/architecture.md)**

**Наступление служит защите.** Запланированный цикл [Offensive Vaccine](https://github.com/bittersecurity/decepticon/blob/main/docs/offensive-vaccine.md) будет превращать находки в улучшения защиты через цикл атака → защита → проверка.

---

## Архитектура

<div align="center">
  <img src="https://raw.githubusercontent.com/bittersecurity/decepticon/main/assets/decepticon_infra.svg" alt="Decepticon Infrastructure" width="680">
</div>

Двухсетевая архитектура. **Постоянно работающая** плоскость управления (LiteLLM, PostgreSQL, Skillogy, LangGraph) и постоянно работающая плоскость песочницы остаются активными на протяжении всего проекта; всё остальное — **динамически запускаемое**: веб-панель поднимается на `/web` из CLI, а специализированные рабочие нагрузки (BloodHound CE, Sliver C2, REA/Ghidra, …) запускаются только когда оркестратор вызывает `ops_start(...)` (см. [ADR-0006](https://github.com/bittersecurity/decepticon/blob/main/docs/adr/0006-agent-driven-container-lifecycle.md)). Сети: управление в `decepticon-net`; песочница + сервер C2 + цели в `sandbox-net`. Neo4j подключён к обеим сетям, чтобы агент (в плоскости управления) мог сохранять находки, записанные изнутри песочницы.

→ **[Глубокое погружение в архитектуру](https://github.com/bittersecurity/decepticon/blob/main/docs/architecture.md)** · **[Граф знаний](https://github.com/bittersecurity/decepticon/blob/main/docs/knowledge-graph.md)**

---

## Агенты

16 специализированных агентов, организованных по фазам kill chain, со свежим контекстным окном для каждой задачи — без накопления шума.

Оркестрация · Разведка · Эксплуатация · Постэксплуатация · Исследование уязвимостей · Доменные специалисты (AD, облака, смарт-контракты, реверс-инжиниринг, аналитик).

→ **[Полный список агентов и стек middleware](https://github.com/bittersecurity/decepticon/blob/main/docs/agents.md)**

---

## Модели и провайдеры

Цепочка резервных вариантов на основе уровней с учётом учётных данных. Вы объявляете, какие учётные данные у вас есть, в порядке приоритета; Decepticon строит из них цепочку основной→резервный на каждом уровне.

| Профиль | Уровень для каждого агента | Сценарий использования |
|---------|----------------|----------|
| **eco** (по умолчанию) | Для каждого агента (HIGH для оркестратора/эксплуататора/патчера/аналитика, MID для исполнения, LOW для разведки/soundwave) | Продакшн |
| **max** | Все агенты на HIGH | Цели высокой ценности |
| **test** | Все агенты на LOW | Разработка / CI |

**Провайдеры, сопоставленные с уровнями**: Anthropic, OpenAI, Google Gemini, MiniMax, DeepSeek, xAI, Mistral, OpenRouter, Nvidia NIM, Ollama (локально).
**OAuth по подписке**: Claude Max/Pro/Team, ChatGPT Pro/Plus/Team, Gemini Advanced, Copilot Pro, SuperGrok, Perplexity Pro.

Настройка через `decepticon onboard`. → **[Полный справочник моделей и примеры резервных вариантов](https://github.com/bittersecurity/decepticon/blob/main/docs/models.md)**

---

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

| Тема | Документ |
|-------|-----|
| Установка и первый проект | [Начало работы](https://github.com/bittersecurity/decepticon/blob/main/docs/getting-started.md) |
| Полная настройка, OAuth, провайдеры, панель управления | [Руководство по настройке](https://github.com/bittersecurity/decepticon/blob/main/docs/setup-guide.md) |
| Обёртка CLI для кодирующего агента | [Навык Decepticon](https://github.com/bittersecurity/decepticon/blob/main/skills/decepticon/SKILL.md) |
| Документация и карта репозитория | [Индекс документации](https://github.com/bittersecurity/decepticon/blob/main/docs/README.md) |
| Все команды CLI и сочетания клавиш | [Справочник CLI](https://github.com/bittersecurity/decepticon/blob/main/docs/cli-reference.md) |
| Все цели `make` | [Справочник Makefile](https://github.com/bittersecurity/decepticon/blob/main/docs/makefile-reference.md) |
| Список агентов и middleware | [Агенты](https://github.com/bittersecurity/decepticon/blob/main/docs/agents.md) |
| Реверс-инжиниринг REA/Ghidra | [Реверс-инжиниринг REA](https://github.com/bittersecurity/decepticon/blob/main/docs/features/rea-reversing.md) |
| Локальный оборонительный мониторинг | [Blue Cell](https://github.com/bittersecurity/decepticon/blob/main/docs/features/blue-cell.md) |
| Профили моделей и цепочка резервных вариантов | [Модели](https://github.com/bittersecurity/decepticon/blob/main/docs/models.md) |
| Система навыков и спецификация формата | [Навыки](https://github.com/bittersecurity/decepticon/blob/main/docs/skills.md) |
| Возможности и настройка веб-панели | [Веб-панель](https://github.com/bittersecurity/decepticon/blob/main/docs/web-dashboard.md) |
| Расширение возможностей, навыков, рабочих процессов и клиентов | [Контракт расширения](https://github.com/bittersecurity/decepticon/blob/main/docs/design/extension-contract.md) |
| Архитектура системы и сетевая изоляция | [Архитектура](https://github.com/bittersecurity/decepticon/blob/main/docs/architecture.md) |
| Граф знаний Neo4j | [Граф знаний](https://github.com/bittersecurity/decepticon/blob/main/docs/knowledge-graph.md) |
| Сквозной рабочий процесс проекта | [Рабочий процесс проекта](https://github.com/bittersecurity/decepticon/blob/main/docs/engagement-workflow.md) |
| Цикл Offensive Vaccine | [Offensive Vaccine](https://github.com/bittersecurity/decepticon/blob/main/docs/offensive-vaccine.md) |
| История релизов | [Журнал изменений](https://github.com/bittersecurity/decepticon/blob/main/CHAGELOG.md) |
| Участие в разработке Decepticon | [Участие в разработке](https://github.com/bittersecurity/decepticon/blob/main/docs/contributing.md) |

---

## Участие в разработке

```bash
git clone https://github.com/BitterSecurity/Decepticon.git
cd Decepticon
make dogfood  # Full OSS UX (launcher → onboard → CLI) on local code
make dev      # Backend hot-reload (compose watch) — daily dev loop
```

→ **[Руководство по участию](https://github.com/bittersecurity/decepticon/blob/main/docs/contributing.md)**

---

## Сообщество

Присоединяйтесь к [Discord](https://discord.gg/TZUYsZgrRG) — задавайте вопросы, делитесь журналами взаимодействий, обсуждайте техники.

---

## Отказ от ответственности

Не используйте этот проект в любой системе или сети без явного письменного разрешения владельца системы. Несанкционированный доступ к компьютерным системам является незаконным. Вы несёте полную ответственность за свои действия. Авторы и участники не несут никакой ответственности за неправомерное использование.

---

## Лицензия

[Apache-2.0](https://github.com/bittersecurity/decepticon/blob/main/LICENSE)

---

## Благодарности

Спасибо мейнтейнерам и участникам проектов, на которых Decepticon строится,
которые интегрирует и у которых учится.

| Проект | Роль в Decepticon |
|---------|--------------------|
| [REA](https://github.com/morluto/rea) и [Ghidra](https://github.com/NationalSecurityAgency/ghidra) | Опциональная нагрузка обратной разработки и бинарный анализ с опорой на доказательства. [Подробности интеграции](https://github.com/bittersecurity/decepticon/blob/main/docs/features/rea-reversing.md). |
| [Deep Agents](https://github.com/langchain-ai/deepagents) и [LangGraph](https://github.com/langchain-ai/langgraph) | Каркас агентов, оркестрация, потоковая передача и постоянное состояние выполнения. |
| [LiteLLM](https://github.com/BerriAI/litellm) | Шлюз моделей и маршрутизация провайдеров. |
| [insane-search](https://github.com/fivetaku/insane-search) | Вышестоящий движок, адаптированный для веб-доступа из песочницы. [Уведомление об адаптации](https://github.com/bittersecurity/decepticon/blob/main/packages/decepticon/decepticon/sandbox_web/NOTICE.md). |
| [Playwright](https://github.com/microsoft/playwright) | Автоматизация браузера для веб-расследований. |
| [Caddy](https://github.com/caddyserver/caddy) и [Fluent Bit](https://github.com/fluent/fluent-bit) | Локальный приём данных сенсоров Blue и сбор журналов. [Архитектура Blue Cell](https://github.com/bittersecurity/decepticon/blob/main/docs/features/blue-cell.md). |
| [Ink](https://github.com/vadimdemedes/ink), [Bubble Tea](https://github.com/charmbracelet/bubbletea) и [Huh](https://github.com/charmbracelet/huh) | Интерактивный рендеринг CLI и формы лаунчера. |
| [PayloadsAllTheThings](https://github.com/swisskyrepo/PayloadsAllTheThings), [h4cker](https://github.com/The-Art-of-Hacking/h4cker) и [Awesome-Hacking](https://github.com/Hack-with-Github/Awesome-Hacking) | Справочные материалы по безопасности и обучению. [Подробности атрибуции](https://github.com/bittersecurity/decepticon/blob/main/THIRD_PARTY_LICENSES.md). |
| [XBOW validation benchmarks](https://github.com/XBOW-engineering/validation-benchmarks) | Задачи оценки, используемые интеграцией бенчмарков. [Результаты и методология](https://github.com/bittersecurity/decepticon/blob/main/benchmark/results/README.md). |

Для проектирования взаимодействия в CLI мы также изучили
[Claude Code](https://code.claude.com/docs/en/interactive-mode),
[Codex CLI](https://github.com/openai/codex) и
[Gemini CLI](https://github.com/google-gemini/gemini-cli).
[Обзор справочника CLI](https://github.com/bittersecurity/decepticon/blob/main/docs/cli-experience.md) фиксирует сделанный выбор.

Лицензии вышестоящих проектов и уведомления об атрибуции остаются в силе; см.
[сторонние лицензии](https://github.com/bittersecurity/decepticon/blob/main/THIRD_PARTY_LICENSES.md) и уведомления рядом с адаптированным кодом.