Skip to content

Repository files navigation

💀 DarkDecoder

Dual-Framework Cyber Threat Intelligence Platform

Paste suspicious code or AI inputs. Get instant threat intelligence mapped to MITRE ATT&CK and MITRE ATLAS in under 20 seconds.

PythonStreamlitGroqMITRE ATT&CKMITRE ATLASLicenseCI


What Is DarkDecoder?

DarkDecoder is the only free tool that combines two official cyber threat frameworks — MITRE ATT&CK for traditional malware and MITRE ATLAS for AI/ML adversarial threats — in a single platform.

Security analysts waste hours manually cross-referencing malicious code against threat databases. DarkDecoder does it in 20 seconds: paste code or a suspicious prompt, get a full breakdown — danger score, technique mappings, IOCs, kill chain, remediation steps, and exportable reports.

MITRE ATLAS coverage: 40+ techniques across 13 tactics — including all LLM-specific techniques (prompt injection, jailbreak, meta-prompt extraction, plugin compromise, LLM data leakage).


Three Analysis Modules

Module 1 — Malware Scanner (MITRE ATT&CK)

  • Deobfuscates base64, hex, eval chains, string concatenation
  • Classifies malware type: Ransomware, Keylogger, Reverse Shell, Cryptominer, Webshell, and more
  • Danger score 1–10 with full justification
  • Maps to MITRE ATT&CK T-codes (T1059, T1547, T1486, etc.)
  • Extracts IOCs: IPs, domains, URLs, file paths, registry keys, mutexes
  • Plain English summary for non-technical stakeholders
  • Actionable remediation steps

Module 2 — AI Threat Analyzer (MITRE ATLAS v4)

  • 40+ ATLAS techniques across all 13 tactics: Reconnaissance, Resource Development, Initial Access, ML Model Access, Execution, Persistence, ML Attack Staging, Defense Evasion, Discovery, Collection, Exfiltration, and Impact
  • Detects LLM-specific attacks: prompt injection (AML.T0051), jailbreak (AML.T0054), meta-prompt extraction (AML.T0058), plugin compromise (AML.T0057), LLM data leakage (AML.T0056)
  • Flags training data poisoning, backdoor insertion, model extraction, membership inference
  • Identifies ML supply chain attacks and surrogate model construction
  • Dual-Framework mode: run both ATLAS + ATT&CK on the same input when code targets ML infrastructure

Module 3 — Red Team Intel (ATT&CK Kill Chain)

  • Full 10-phase ATT&CK kill chain visualization
  • Weaponization score + stealth rating (1–10)
  • Privilege escalation level: None → Local → Admin → Domain Admin → SYSTEM/Root
  • Detection difficulty rating + CVSS vector string generation
  • Named APT group / threat actor similarity matching
  • Full attack narrative from an adversary perspective

Features

FeatureDetails
File Upload.py .js .php .ps1 .sh .bat .rb .go .cs .vbs (up to 200 MB)
Report ExportPDF · JSON · TXT — one click, all modules
Attack TimelineStep-by-step progression with MITRE technique IDs
Session HistoryAll scans logged with timestamps in sidebar
Hash AnalysisSHA256 + MD5 computed on every submission
Built-in SamplesPre-loaded demo payloads including GCG suffix + Crescendo escalation
Zero CostRuns entirely on Groq's free tier — no credit card
ATLAS Depth40+ techniques, 13 tactics, tactic name shown per technique

Tech Stack

ComponentTechnology
AI EngineGroq API — Llama 3.3 70B Versatile
Threat Framework 1MITRE ATT&CK v14
Threat Framework 2MITRE ATLAS v4 (AI/ML adversarial threats)
BackendPython 3.10+
FrontendStreamlit
PDF Generationfpdf2
Environmentpython-dotenv

Quick Start

# 1. Clone
git clone https://github.com/Pyhroff/darkdecoder
cd darkdecoder
# 2. Install dependencies
pip install -r requirements.txt
# 3. Add your free Groq API key
cp .env.example .env
# Open .env and set: GROQ_API_KEY=your_key_here# 4. Run
streamlit run app.py

Get a free Groq API key at console.groq.com — no credit card, 14,400 requests/day free tier.


Built-in Demo Samples

ModuleSample Payloads
Malware ScannerPowerShell Dropper · Python Reverse Shell · JS Cryptominer · PHP Webshell · Ransomware Stub
AI Threat AnalyzerPrompt Injection · Data Poisoning · Model Extraction · Jailbreak · GCG Adversarial Suffix · Crescendo Escalation
Red Team IntelPrivilege Escalation · Lateral Movement · Defense Evasion · C2 Beacon

Why DarkDecoder?

DarkDecoderVirusTotalTraditional SIEMs
MITRE ATT&CK mappingPartial✅ (paid)
MITRE ATLAS (AI threats)✅ 40+ techniques
Red team kill chain
LLM-specific attacks
Free tier
Self-hostable

Project Structure

darkdecoder/
├── app.py # Main Streamlit UI (3 modules + dual-framework mode)
├── analyzer.py # MITRE ATT&CK malware scanner
├── ai_analyzer.py # MITRE ATLAS v4 AI threat detector (40+ techniques)
├── redteam_analyzer.py # Red team kill chain analyzer
├── report_generator.py # PDF report generation
├── requirements.txt
├── .env.example
└── .gitignore

Security Portfolio

DarkDecoder is part of a three-project AI security portfolio:

ProjectRoleFrameworks
DarkDecoderThreat intelligence — what is the attack?MITRE ATT&CK + ATLAS
PromptStrikeActive red teaming — can you jailbreak it?PAIR · TAP · Crescendo · GCG
SOC PARALLAXBehavioral defense — detect the attackerNeo4j · LangGraph · Ollama

License

MIT License — free to use, modify, and deploy.


DarkDecoder — Because malware doesn't explain itself.

About

🛡️ Dual-framework cyber threat-intel platform — paste suspicious code, get AI-powered MITRE ATT&CK + ATLAS analysis, IOCs, and a red-team kill chain in under 20s. Python · Streamlit · Groq Llama 3.3 70B.

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages