Skip to content

Pyhroff/darkdecoder

Repository files navigation

πŸ’€ DarkDecoder

Dual-Framework Cyber Threat Intelligence Platform

Paste suspicious code. Get instant AI-powered threat intelligence in under 20 seconds β€” mapped to MITRE ATT&CK and MITRE ATLAS.

Python Streamlit Groq MITRE ATT&CK MITRE ATLAS License CI


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, get a full breakdown β€” danger score, technique mappings, IOCs, kill chain, remediation steps, and exportable reports.


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)

  • Detects prompt injection attacks targeting LLM-based systems
  • Identifies jailbreak and safety guardrail bypass techniques
  • Flags training data poisoning and backdoor injection samples
  • Catches model extraction and membership inference queries
  • Maps directly to MITRE ATLAS AML.TXXXX codes β€” the official AI adversarial threat framework

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

Feature Details
File Upload .py .js .php .ps1 .sh .bat .rb .go .cs .vbs (up to 200 MB)
Report Export PDF Β· JSON Β· TXT β€” one click, all modules
Attack Timeline Step-by-step progression with MITRE technique IDs
Session History All scans logged with timestamps in sidebar
Hash Analysis SHA256 + MD5 computed on every submission
Built-in Samples Pre-loaded demo payloads for instant testing
Zero Cost Runs entirely on Groq's free tier β€” no credit card

Tech Stack

Component Technology
AI Engine Groq API β€” Llama 3.3 70B Versatile
Threat Framework 1 MITRE ATT&CK v14
Threat Framework 2 MITRE ATLAS (AI/ML adversarial threats)
Backend Python 3.10+
Frontend Streamlit
PDF Generation fpdf2
Environment python-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

Module Sample Payloads
Malware Scanner PowerShell Dropper Β· Python Reverse Shell Β· JS Cryptominer Β· PHP Webshell Β· Ransomware Stub
AI Threat Analyzer Prompt Injection Β· Data Poisoning Β· Model Extraction Β· Jailbreak Attempt
Red Team Intel Privilege Escalation Β· Lateral Movement Β· Defense Evasion Β· C2 Beacon

Why DarkDecoder?

DarkDecoder VirusTotal Traditional SIEMs
MITRE ATT&CK mapping βœ… Partial βœ… (paid)
MITRE ATLAS (AI threats) βœ… ❌ ❌
Red team kill chain βœ… ❌ ❌
Free tier βœ… βœ… ❌
Self-hostable βœ… ❌ ❌
Explains WHY βœ… ❌ ❌

Project Structure

darkdecoder/
β”œβ”€β”€ app.py                 # Main Streamlit UI
β”œβ”€β”€ analyzer.py            # MITRE ATT&CK malware scanner
β”œβ”€β”€ ai_analyzer.py         # MITRE ATLAS AI threat detector
β”œβ”€β”€ redteam_analyzer.py    # Red team kill chain analyzer
β”œβ”€β”€ report_generator.py    # PDF report generation
β”œβ”€β”€ requirements.txt
β”œβ”€β”€ .env.example
└── .gitignore

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

License

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages