P
PurpleAILAB/Decepticon
Autonomous Hacking Agent for Red Team
agentaicybersecuritygenerative-aihackinglangchainlanggraphllmpentestpentesting
PythonApache-2.0创建于 2025/6/6更新于 今天
README
由 Gemini 翻译整理
Decepticon — 自主红队智能体 (Autonomous Red Team Agent)
“又一个 AI 黑客工具？让我们猜猜——它是不是只会跑个 nmap 然后写份报告？”
安装
前置条件：Docker 和 Docker Compose v2。 支持 macOS (Apple Silicon + Intel)、Linux (amd64 + arm64) 以及 Windows (amd64 + arm64) — 支持原生 PowerShell 或通过 WSL2 (Ubuntu / Kali) 运行。
macOS / Linux / WSL2
curl -fsSL https://decepticon.red/install | bash
decepticon onboard # 交互式设置向导（提供 provider、API key、模型配置）
decepticon # 启动所有服务：终端 CLI + Web 控制面板 (http://localhost:3000)
Windows (原生 PowerShell)
irm https://decepticon.red/install.ps1 | iex
decepticon onboard
decepticon
作为库使用 (pip)
基于智能体构建 SaaS、研究集成或自定义编排器？请通过 PyPI 安装 SDK：
pip install decepticon # 核心 SDK
pip install "decepticon[neo4j]" # + 知识图谱攻击链工具
decepticon 是一个 Client SDK：它提供了智能体工厂、中间件、工具和技能，并通过 HTTP (DECEPTICON_LLM__PROXY_URL, SAAS_SANDBOX_URL) 将 LLM 调用和沙箱执行路由到运行时服务。运行智能体仍然需要这些服务——请使用上述 Docker 栈，或者将 URL 指向您自己的等效服务。有关工厂覆盖界面、声明式 PluginBundle 插件和安全网关的详细信息，请参阅 Decepticon 作为库使用。
💖 支持 Decepticon
我们致力于将 Decepticon 打造成针对 AI 驱动型威胁场景的**“进攻性疫苗”(Offensive Vaccine)**。如果您认同自主红队是强化防御的有效路径，请考虑支持本项目。
基准测试 (Benchmark)
| 基准测试 | 难度 | 通过率 |
|---|---|---|
| XBOW validation-benchmarks | 简单 (Level 1) | 45 / 45 (100 %) |
| XBOW validation-benchmarks | 中等 (Level 2) | 50 / 51 (98.0 %) |
| XBOW validation-benchmarks | 困难 (Level 3) | 7 / 8 (87.5 %) |
| XBOW validation-benchmarks | 所有等级 | 102 / 104 (98.08 %) |
- 各挑战完整索引、攻击类别矩阵及 LangSmith 追踪记录
- 与其他 AI 渗透测试智能体的对比 (Strix, PentestGPT, MAPTA, Cyber-AutoAgent, XBOW commercial, …)
什么是 Decepticon？
“AI + 黑客”领域充斥着只能跑 nmap 并打印报告的演示工具，但这并非本项目。
Decepticon 是一个专业的自主红队智能体。 它能够像真实的攻击者那样执行现实的攻击链——侦察、漏洞利用、提权、横向移动、C2 等，而不是像扫描器那样简单操作。
更重要的是：它严格遵循将红队专家与“脚本小子”区分开来的规程。在发送任何数据包之前，Decepticon 会生成完整的任务包——包括 RoE (交战规则)、ConOps (作战概念)、Deconfliction Plan (冲突协调计划) 以及带有 MITRE ATT&CK 映射的 OPPLAN (作战计划)，所有操作均在定义的规则内执行。
为什么选择 Decepticon？
真实的杀伤链 (Kill chains)，而非简单的复选框式扫描。 Decepticon 读取 OPPLAN 并通过任何可行的路径追求目标——通过透视、适应环境、串联多种技术。
真正的交互式 Shell。 真实的进攻工具是交互式的（如 msfconsole, sliver-client, evil-winrm）。Decepticon 在带有自动提示符检测的持久 tmux 会话中运行每个命令，因此当工具进入交互式提示符时，智能体可以在无需变通的情况下发送后续命令。
强化后的沙箱隔离。 所有命令都在专用操作网络 (sandbox-net) 的 Kali Linux 沙箱中运行，与管理平面 (decepticon-net) 分离。LangGraph 通过 Docker 套接字驱动沙箱。→ 架构设计
进攻服务于防御。 计划中的 “进攻性疫苗” 循环将通过“攻击 -> 防御 -> 验证”周期，将研究结果转化为防御层面的改进。
架构
采用双网络设计——管理服务（LiteLLM, PostgreSQL, LangGraph, Web）位于 decepticon-net；沙箱及 C2 位于独立环境。