
pii-veil
io.github.glastor-core/pii-veil
Sub-millisecond reversible PII & secret anonymizer in Rust for LLMs, agents, and MCP
Documentation
🛡️ pii-veil: Ultrafast Reversible PII & Secret Anonymizer
⚡ Live WASM Demo • Key Capabilities • Quickstart • Benchmarks • Compliance (GDPR / HIPAA / PCI-DSS / LGPD) • Kubernetes Sidecar • Enterprise Support • Examples
[!IMPORTANT] Need Enterprise On-Premise deployment, SOC2/HIPAA compliance logs, or custom rules?
Contact our founder and enterprise team at founder@glastor.es for on-premise air-gapped VPCs, custom compliance rules, and SLAs.
pii-veil is a sub-millisecond, zero-bloat Rust engine for detecting, anonymizing, and restoring PII and secrets across LLM prompts, MCP agents, HTTP/SSE proxies, JSON/NDJSON logs, CSVs, and multi-gigabyte SQL dumps.
Designed with the 6-in-1 Multi-Market Architecture:
crates/veil-core(crates.iolibrary:pii-veil-core)crates/veil-cli(crates.io/ Homebrew CLI binary + built-in MCP Server & HTTP/SSE Proxy:veil)crates/veil-ffi(crates.ioC-ABIcdylib/staticlib+pii_veil.h:pii-veil-ffi)crates/veil-py(PyPIpackage viaPyO3&maturin:glastor-pii-veil)crates/veil-node(npmpackage vianapi-rs:pii-veil-node)sdks/go(Go SDK +net/httpDLP middleware + Rustveil mcpbridge:github.com/glastor-core/pii-veil/sdks/go)
✨ Key Capabilities
- Reversible LLM Roundtrip & Real-Time SSE Streaming (
PlaceholderMode): Replaces sensitive data with semantic tokens ([EMAIL_1],[CREDIT_CARD_1],[IBAN_1]), restores full responses in $O(N)$ viaaho-corasick, or restores live token streams chunk-by-chunk ([EMA+IL_1]) viaStreamingRestorer. - Built-in Model Context Protocol (
veil mcp) & HTTP/SSE Proxy (veil proxy):veil mcp: Zero-dependency JSON-RPC 2.0 MCP server overstdioexposingveil_redact,veil_restore,veil_redact_json, andveil_scandirectly to Claude Desktop, Cursor, and Windsurf.- Official MCP Registry Name:
mcp-name: io.github.glastor-core/pii-veil veil proxy: Local HTTP/SSE reverse proxy (127.0.0.1:8080) that redacts outgoing LLM JSON prompts and restores incomingtext/event-streamSSE or JSON responses in real time.
- 18 Built-in Detectors with Mathematical Checksum Verification:
- Financial: Credit Cards (Luhn checksum) and IBANs (ISO 13616 Mod-97 checksum).
- Regional National IDs: US SSN, Spain DNI/NIE (Mod-23 letter table), Argentina CUIT/CUIL (Mod-11 weights), and Chile RUT (Mod-11 verifier).
- Cloud, AI & Infra Secrets: Database Connection URIs (
postgres://,mysql://,mongodb+srv://,redis://), Slack/Discord Webhooks, OpenAI, Anthropic, AWS, GitHub, Slack, Google API, Stripe keys, JWTs, and PEM Private Keys. - Network & Contact: Emails, Phones, IPv4, IPv6, and MAC addresses.
- Authenticated Encrypted Vaults (
--vault-pass): Export and restore.vaultfiles encrypted and authenticated with a passphrase for safe storage in Redis, S3, or disk. - Constant-Memory Streaming (
Lines,NDJSON,SQL,CSV): Anonymize and restore multi-gigabytepg_dumpSQL streams (COPY ... FROM stdin), column-aware.csvfiles, and.jsonllogs in $O(1)$ memory per line.
🚀 Quickstart
1. Interactive Demo & Benchmark (Rust CLI)
cargo run --release -p pii-veil-cli -- demo
cargo run --release -p pii-veil-cli -- bench
2. Local HTTP/SSE DLP Proxy (veil proxy)
# Start in local LLM echo/SSE simulator mode (or pass --upstream host:port)
veil proxy --listen 127.0.0.1:8080 --echo
3. Redact & Restore with Encrypted Vault (--vault-pass)
# Redact text and save an authenticated encrypted vault
veil redact \
--text "Charge maria@startup.io (CUIT 20-12345678-6) on card 4532-0151-1283-0366" \
--vault-out vault.enc \
--vault-pass "my-secret-passphrase"
# Restore original values from LLM response
veil restore \
--text "Invoice sent to [EMAIL_1] (tax ID [NATIONAL_ID_1]) for card [CREDIT_CARD_1]." \
--vault vault.enc \
--vault-pass "my-secret-passphrase"
4. Stream Multi-GB SQL Dumps, CSVs, or NDJSON Logs
# Anonymize a PostgreSQL dump with deterministic synthetic data (Luhn & Mod-97 valid)
pg_dump mydb | veil stream --format sql --mode synthetic --key "prod-seed" > anon_dump.sql
# Anonymize a CSV file (detects sensitive column headers like password/api_key + regex PII)
veil stream --input users.csv --output anon_users.csv --format csv --vault-out csv.vault
# Stream-restore a huge file in O(1) memory per line
veil restore --file anon_users.csv --output restored_users.csv --vault csv.vault --stream
5. Go SDK (sdks/go)
cd sdks/go
go test -v ./...
6. GitHub Action (glastor-core/pii-veil@v1)
Use pii-veil as a sub-millisecond DLP gatekeeper in any GitHub Actions workflow:
- name: 🛡️ PII & Secret DLP Audit
uses: glastor-core/pii-veil@v1
with:
path: "."
exclude: "examples,tests"
fail-on-detect: "true"
7. MCP Server Setup (Claude Desktop, Cursor & Windsurf)
pii-veil ships with a zero-dependency Model Context Protocol (MCP) server (veil mcp) over stdio exposing four tools: veil_redact, veil_restore, veil_redact_json, and veil_scan.
Official MCP Registry identifier: mcp-name: io.github.glastor-core/pii-veil
Add to your claude_desktop_config.json, Cursor (~/.cursor/mcp.json), or Windsurf MCP config:
Using the native Rust binary (cargo install pii-veil-cli):
{
"mcpServers": {
"pii-veil": {
"command": "veil",
"args": ["mcp"]
}
}
}
Using Docker (< 15 MB Distroless image):
{
"mcpServers": {
"pii-veil": {
"command": "docker",
"args": ["run", "-i", "--rm", "ghcr.io/glastor-core/pii-veil:latest", "mcp"]
}
}
}
📂 Production Examples (examples/)
examples/python_fastapi_llm_streaming.py— FastAPI + OpenAI/Anthropic SSE streaming withStreamingRestorerand encrypted Vaults.examples/typescript_nextjs_ai_sdk.ts— Next.js / Vercel AI SDKTransformStreamwithVeilStreamingRestorer.examples/go_http_dlp_middleware.go— Gonet/httpDLP middleware (piiveil.NewDlpMiddleware) & SSE restorer.examples/git_pre_commit_hook.sh— Git pre-commit DLP hook powered byveil scan --fail-on-detect.
🏢 Enterprise & Commercial Support
Are you deploying LLMs or AI agents in production and need guaranteed compliance with GDPR, HIPAA, PCI-DSS, or SOC 2?
We offer enterprise licenses and dedicated infrastructure solutions:
- On-Premise & Air-Gapped Deployments: Hardened Kubernetes Helm charts, high-availability sidecars, and zero-external-egress setups for banks, healthcare, and fintech.
- Enterprise SIEM & Telemetry: Live audit streaming to Datadog, Splunk, AWS CloudWatch, and OpenTelemetry collector endpoints.
- Custom DLP Detectors & Proprietary Rules: Tailored regex patterns, custom checksum algorithms, and domain-specific sensitive data classifications.
- 24/7 SLA & Architecture Review: Priority engineering support, guaranteed response times, and LLM streaming pipeline benchmarking.
📩 Need Enterprise On-Premise deployment, SOC 2 / HIPAA compliance logs, or custom rules?
Contact us directly at: founder@glastor.es
pii-veil-clicargo install pii-veil-cli