mind-security
AI security toolkit with four active modules.
Quick Reference
| Task | Command | Docs |
|---|---|---|
| Deepfake detection | python3 scripts/check_deepfake.py <path_or_url> | deepfake-detection.md |
| Prompt injection scan | python3 scripts/check_prompt_injection.py "<text>" | prompt-injection.md |
| Malware/phishing scan | python3 scripts/check_malware.py "https://..." | malware-scanning.md |
| AI text detection | python3 scripts/check_ai_text.py "<text>" | ai-text-detection.md |
Modules
Deepfake detection — BitMind API (Bittensor Subnet 34) for images and videos. Supports YouTube, Twitter/X, TikTok URLs. EXIF/metadata fallback for local images. Set BITMIND_API_KEY (get key).
Prompt injection — Multi-layer: 50+ regex patterns (instant, zero-dep) + LLM Guard ML scanner (optional, pip install llm-guard). Detects DAN jailbreaks, prompt extraction, context manipulation, and novel attacks.
Malware/phishing scanning — VirusTotal (70+ engines), URLScan.io (1500+ brands), Google Safe Browsing, plus local heuristics (typosquatting, suspicious TLDs, phishing patterns). Works with no keys via heuristics.
AI text detection — GPTZero API with per-sentence scoring and ~99% accuracy across GPT-4/5, Claude, Gemini, LLaMA. Requires GPTZERO_API_KEY (get key).
API Keys
| Env Var | Used By | Required | Get It |
|---|---|---|---|
BITMIND_API_KEY | Deepfake detection | For API mode | app.bitmind.ai/api/keys |
GPTZERO_API_KEY | AI text detection | Yes | gptzero.me/dashboard |
VIRUSTOTAL_API_KEY | Malware scanner | Optional | virustotal.com |
URLSCAN_API_KEY | Malware scanner | Optional | urlscan.io |
GOOGLE_SAFE_BROWSING_KEY | Malware scanner | Optional | console.cloud.google.com |
Script Conventions
python3 scripts/<script>.py --help- Core: zero pip dependencies (stdlib only)
- Optional ML:
pip install llm-guardfor prompt injection Layer 2 - JSON to stdout, errors to stderr
- Exit 0 success, exit 1 failure