promptpurify
v0.0.1
Published
Structural prompt firewall for LLM apps. DOMPurify philosophy applied to prompt injection & jailbreak defense — deterministic, honest about its limits.
Maintainers
Readme
promptpurify
Tiny prompt-injection firewall for LLM chat apps. ~14 MB. CPU-only. Drop-in guard between your user input and your LLM — runs on the same box, no GPU, no API, no extra service.
Built by the SecureLayer7 red-team. Most OSS guardrails are hundreds of MB, want a GPU, and still miss the attacks we see in production. We needed something we could ship inside our own AI products and our customers' apps without any of that.
Why this exists
| | promptpurify | typical OSS guardrail | |---|---|---| | Install size | ~14 MB ONNX | 180 MB – 7 GB | | Inference | CPU, single-digit ms | GPU recommended | | Where it runs | In your Node process | Sidecar or hosted API | | Cost per call | $0 | $ or GPU compute |
Benchmark comparison vs OSS baselines → docs/BENCHMARKS.md.
Install
# SDK (zero-dep, ~50 KB) — structural firewall + browser bundle
npm i promptpurify
# Add the model (~14 MB ONNX) for the chat-injection guard
npm i onnxruntime-node
curl -L -o promptpurify-model.tar.gz \
https://github.com/securelayer7/PROMPTPurify/releases/download/v0.0.1/promptpurify-model.tar.gz
curl -L -o promptpurify-model.tar.gz.sha256 \
https://github.com/securelayer7/PROMPTPurify/releases/download/v0.0.1/promptpurify-model.tar.gz.sha256
sha256sum -c promptpurify-model.tar.gz.sha256 # MUST print "OK"
tar xzf promptpurify-model.tar.gz # creates models/l5e/The model isn't in the npm tarball — the SDK stays tiny for people who only want the structural firewall (browser, edge, RAG). Full distribution options: docs/SAMPLE-DATA.md.
3-line drop-in
import { createL5eRunner } from "promptpurify/l5";
const guard = await createL5eRunner();
// In your /chat handler:
const score = await guard.score(userMessage);
if (score >= 0.95) return refusal(); // hard block
if (score >= 0.85) flagForReview(userMessage); // advisory
const reply = await yourLLM.complete(userMessage); // pass throughWorks with Groq, OpenAI, Anthropic, vLLM, local LLMs — promptpurify never talks to your LLM, only to your input.
For the deterministic structural firewall (Unicode neutralization, role-fenced messages, output exfil guard) see docs/QUICKSTART.md.
Built from scratch
We built our model from random initialization because no existing OSS guardrail gave us the size / latency tradeoff we wanted to ship in our own products.
- From-scratch. No teacher weights from any vendor classifier are redistributed.
- Benchmarked against public datasets for direct comparison with OSS baselines (ProtectAI v2, deepset, fmops, Meta Prompt-Guard-2). Held-out evaluation; false positives reported alongside recall.
- MIT-licensed weights. Use in production, paid or free.
Full architecture overview → docs/HOW-IT-WORKS.md.
Try to break it
We run a live adversarial challenge at anton.securelayer7.net. Ask Son of Anton for the password. If you can get it past the guard, tell us how — SECURITY.md.
Sample app
A fintech customer-support chatbot wired up with promptpurify, ready to run locally:
cd examples/customer-support && npm install
GROQ_API_KEY=gsk_... node server.mjs
# http://localhost:8787See examples/customer-support/README.md.
Read more
- docs/QUICKSTART.md — install paths, structural firewall, browser bundle, integration patterns.
- docs/HOW-IT-WORKS.md — the layers, what each catches.
- docs/BENCHMARKS.md — comparison with OSS baselines, methodology.
- docs/SAMPLE-DATA.md — what ships in the repo for benchmarking.
- docs/REPRODUCE.md — run the bench yourself.
- docs/HONEST-LIMITS.md — what to pair promptpurify with for full coverage.
What promptpurify is not
- Not a guarantee. There is no
.safeboolean. - Not a content classifier. Catches prompt-injection, not toxicity / CSAM / hate. Pair with a content filter.
- Not a multi-turn auditor. Pair with conversation-level monitoring.
Acknowledgments
The name and the design philosophy are inspired by DOMPurify by Cure53 — the same idea, applied to LLM prompts instead of HTML. Thanks to Mario Heiderich for suggesting the name.
License
MIT for the SDK and the model weights. Benchmark sources we evaluate against are listed in training/CORPUS_LICENSES.json.
Security disclosures: SECURITY.md.
