mrkeyoor.com_
Fri 16 Oct 18:51 UTC
AI Toolsevaluationupdated 10 Oct 2026

Decepticon review

Decepticon is an autonomous red-team system that uses language-model agents to plan authorized security engagements and run tools inside a Kali Linux sandbox. It coordinates work across an engagement, including interactive shells and stored findings, for operators who can review the plan and its results.

+303stars / 7d
Verdict

Our Decepticon run installed 1615 packages and used 1490 MB, but the web build failed after 32 seconds and npm audit reported 46 known vulnerabilities. I'd reserve this revision for a controlled evaluation by experienced operators who can maintain its service stack and investigate the failed source build. The supplied run doesn't support calling the dashboard ready or judging the documented Docker route successful.

We ran it

Lab card: what happened when we ran DecepticonScreenshot of Decepticon (decepticon.red)
Install✓ · 78s1615 packages · 1490 MB
Build✗ · 32s
Testsn/ano test script
Known vulns464 critical · 24 high · 11 moderate · 7 low (npm audit)
Repo8000 files~1,022,472 lines of source · 1521.7 MB · 9 CI workflows · tests dir

Answers from our run

Does Decepticon build from source?

Dependencies installed in 78 seconds (1615 packages), and the build failed. We cloned commit db0e726 into a clean Debian container with 3 CPUs and no project-specific setup.

Does Decepticon have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Does Decepticon have known vulnerabilities in its dependencies?

npm audit flagged 46 known advisories in the dependency tree, including 4 critical at the time of our run.

Who should not use Decepticon?

Hosts whose policy forbids application access to the Docker socket: the documented architecture uses it to drive the sandbox.

What are the alternatives to Decepticon?

Strix, PentestGPT, ZAP. Our Decepticon run installed 1615 packages and used 1490 MB, but the web build failed after 32 seconds and npm audit reported 46 known vulnerabilities.

Setup2/578-second npm install; web build failed; runtime needs services
Docs4/5Separate setup, architecture, SDK, and dashboard instructions
Community4/5October push and release, with detailed diagnostic follow-up
Maturity2/5Source web build failed; measured path skipped tests

Who it’s for

Experienced red-team operators evaluating autonomous work against explicitly authorized lab targets.
Security teams able to operate Docker services, provider authentication, PostgreSQL, and Neo4j.
Researchers integrating agent factories into their own runtime services.
Claude Code and MCP users who want their coding agent to control an already running Decepticon stack.

Who it’s NOT for

Hosts whose policy forbids application access to the Docker socket: the documented architecture uses it to drive the sandbox.
Developers expecting the Python SDK to supply its own runtime: the README says model and sandbox services are still required.
Teams that only need a web vulnerability scan: Decepticon's README describes interactive shells and exploitation chains, which require a broader engagement workflow.
Teams requiring a reproducible source dashboard build from this revision: our web workspace failed, and the dashboard guide describes additional Prisma maintenance steps.
Buyers requiring the full attack-to-defense verification loop now: the README labels that loop planned.

Setup reality

Our run installed commit db0e726 in 78 seconds, adding 1615 packages and using 1490 MB. The build failed with exit code 1 after 32 seconds. Tests were skipped because the selected path had no test script or target. Npm audit reported 46 known vulnerabilities: 4 critical, 24 high, 11 moderate, and 7 low. The log points to module-resolution errors in the web workspace but doesn't identify the missing modules.

The documented launcher needs Docker and Compose plus provider credentials or a local model endpoint. Onboarding saves configuration to ~/.decepticon/.env. The service stack includes LiteLLM, PostgreSQL, Neo4j, LangGraph, and a Kali sandbox. The Python SDK still needs runtime services, and MCP clients need Decepticon running first.

LangGraph controls the sandbox through the Docker socket, so host policy matters. The dashboard starts separately from the CLI and has documented Prisma migration and generation steps. Our unprivileged npm run does not establish whether the Docker route starts successfully or isolates an engagement.

The source dashboard failed before an engagement could prove anything

Decepticon's web workspace failed to build in 32 seconds in our sandbox. That's an awkward first encounter with a system intended to coordinate security engagements, but it identifies a useful boundary: source-build readiness and attack effectiveness need separate evidence. The project supplies autonomous agents for authorized red-team work, with planning documents and persistent interactive shells. I'd evaluate it as infrastructure for an experienced operator who can inspect the commands and findings.

The English README advertises a Docker-backed launcher, a Python SDK, and a hosted commercial app. Our npm run added 1615 packages and occupied 1490 MB. That result belongs to the source workspaces, not the commercial service or a verified Docker engagement. A working demo of one route would not clear the failure in another. Choose your intended deployment path before deciding what evidence of readiness you need.

What happened when we ran it

Our run installed Decepticon commit db0e726 in 78 seconds, then the build failed with exit code 1 after 32 seconds. We used a fresh Debian container on October 10, 2026, with 3 CPUs, 8 GB of RAM, and image lab-node:22, without secrets or elevated privileges. The checkout held 8000 files, roughly 1022472 source lines, and 1521.7 MB before installation. This is a substantial repository to investigate when a setup step breaks.

The failure tail points to Next.js module-resolution errors at clients/web/src/lib/prisma.ts:6:1 and clients/web/src/hooks/useRunObserver.ts:21:1. Npm identifies web@0.0.0 and the command next build. The excerpt doesn't name the missing modules or establish the cause. Although the dashboard documentation describes generating a Prisma client, it would be speculation to declare that the fix. The defensible finding is that the web workspace did not build through our measured route.

Tests were skipped because the selected path exposed no test script or target. A tests directory was present, alongside monorepo workspaces, a compose file, and 9 CI workflow files. The scan reported no Dockerfile. That scan result should stay separate from the documented container deployment. Npm audit reported 46 known vulnerabilities: 4 critical, 24 high, 11 moderate, and 7 low. The supplied summary neither identifies their dependency paths nor proves that deployed services expose them.

Docker services remain necessary behind the Python SDK

The getting-started guide requires a container runtime and a model-provider credential or local model endpoint. Onboarding writes configuration to ~/.decepticon/.env, and the launcher starts the management services plus the sandbox. LiteLLM handles model routing, PostgreSQL stores application data, and Neo4j holds findings and relationships. You also have LangGraph orchestration to operate. The short installer command introduces a service stack with data that survives an engagement.

Our 1490 MB npm footprint doesn't price the container images, database volumes, or a local model. The Python package is a client SDK whose calls still need model and sandbox services. Installing it alone won't create an independent assessment environment. Likewise, Claude Code and other coding agents can connect through MCP, but Decepticon must already be running. The external-agent guide is the relevant route if you want to keep an existing coding interface.

The sandbox boundary includes Docker socket access

The architecture document separates the management and operational networks. LangGraph drives the Kali sandbox through the Docker socket, while a shared Neo4j store connects to both networks. That is a concrete deployment dependency. If your host policy forbids mounting the Docker socket into an application service, this architecture conflicts with it before you get to model selection or the quality of generated findings.

Persistent tmux sessions let an agent send follow-up input to interactive tools instead of treating each command as an isolated process. That's useful when a security workflow requires an ongoing shell. It also makes operator visibility worth evaluating directly. The 3-CPU, 8-GB sandbox result establishes no containment guarantee for the documented runtime: our npm checks didn't exercise those networks or prove that autonomous commands respected an engagement's scope.

Generated plans still require an operator's approval

The first-engagement instructions have Soundwave interview the operator, write scope and handling documents, and hand an operational plan over for review and approval. Those steps suit someone who already knows the permitted targets and exclusions. I'd walk away if I only needed a web vulnerability scan: the interactive shells and exploitation workflow add operating responsibility. ZAP is the narrower alternative for that job, while Strix and PentestGPT deserve comparison for different agent-driven assessment workflows.

After a 78-second install, our source build stopped before we could treat its dashboard as ready. The dashboard guide makes that interface optional and starts it on demand from the CLI. It also documents Prisma migrations and client generation for source changes. Separately, the README describes the attack-to-defense verification loop as planned. Buyers who need that complete loop today should not convert the description into a shipped capability.

October maintenance doesn't close the original empty-response question

The last push was October 10, 2026, and v1.2.5 shipped on October 8 with optional, lazy Skillogy retrieval. GitHub returned 5796 stars and 5 open issues and PRs. Recent activity includes issue 875, an empty-response report, and a related diagnostics fix. The maintainer's comment explicitly says that improving error classification doesn't establish the original cause. The issue is now closed, so closure alone is weak evidence that the reported symptom was repaired.

Decepticon earns a controlled evaluation by operators who want its engagement workflow and can support the service stack. I wouldn't make this source revision a required dashboard build in a delivery pipeline: our build failed, tests were skipped, and 46 dependency advisories need investigation. The next acceptance result should show your chosen deployment reaching a reviewed plan, executing an authorized objective, and preserving evidence you can inspect.

Alternatives

ProjectWhat it isPick it when
Strix gh↗An AI penetration-testing tool focused on finding and fixing application vulnerabilities.pick this instead when application assessment is the main task and you want to compare its workflow with Decepticon's broader engagement system.
PentestGPTA language-model agent framework for penetration-testing workflows.pick this instead when you want a different agent framework for controlled assessment research.
ZAPAn open-source web application security testing proxy and scanner.pick this instead when web vulnerability scanning is the job and you do not need autonomous exploitation chains.

What people are saying

  1. [github-trending] BitterSecurity/Decepticon

Sources

  1. English README and deployment routes
  2. Getting started and engagement approval
  3. Architecture and Docker socket boundary
  4. Library usage and runtime dependencies
  5. External coding-agent integration
  6. Dashboard and Prisma maintenance
  7. Release v1.2.5
  8. Empty-response issue and diagnostic follow-up

More ai tools reviews

universal-modder · DeepEP-Ascend · DeepGEMM-Ascend · hypoarena · jeeves · faster-whisper · the whole board →