blackflagdesignteam/blackshield repository overview

⁠BlackShield PII Detector

Self-hosted API that detects and redacts PII before it reaches any LLM or external service.

⁠Quick Start

docker run -d \
  -p 3000:3000 \
  -e LICENSE_KEY=YOUR-KEY \
  -v blackshield_data:/data \
  blackflagdesignteam/blackshield

Then visit http://localhost:3000⁠ for the interactive demo.

⁠Interactive Demo

The built-in demo lets you paste real content, toggle 25 detection types, test custom patterns, and copy ready-to-use API snippets. Enable or disable it with:

-e SHOW_DEMO=true    # default — demo available at /
-e SHOW_DEMO=false   # API-only, no demo UI

⁠Features

• 25+ PII types — Names, emails, SSNs, credit cards, addresses, credentials, passports, driver's licenses, organizations, and more
• Hybrid AI + regex — DistilBERT NER combined with pattern matching for maximum accuracy
• Smart detection — Auto-detects prose, tables (CSV/TSV/markdown), and mixed content
• Custom patterns — Give 2 examples of your internal IDs, no regex required
• Sub-100ms latency — 30–80ms typical, runs entirely on your infrastructure
• Self-hosted — No data ever leaves your servers

⁠Environment Variables

⁠API

curl -X POST http://localhost:3000/v1/detect \
  -H "Content-Type: application/json" \
  -d '{"text": "Contact John Smith at [email protected]"}'

⁠Purchase

$99 one-time — Buy on Gumroad⁠