Skip to main content

Model-agnostic PII firewall for LLM apps: scan/redact/rescan/verify SDK + a local Claude Code redaction proxy (`shutapp claude`).

Project description

shutapp — the model-agnostic PII firewall

Three lines. Any LLM.

from shutapp import Shutapp

g = Shutapp(api_key="shu_live_...")
safe, session = g.scan("My email is john@acme.com")

# ...send `safe` to any LLM using your own provider key...

final = g.unscan(response_text, session)

Or the 2-line auto-wrap for OpenAI / Anthropic:

from openai import OpenAI
from shutapp import guard
client = guard(OpenAI())          # every .chat.completions.create call is now protected
from anthropic import Anthropic
from shutapp import guard
client = guard(Anthropic())       # every .messages.create call is now protected

Run Claude Code privately — shutapp claude

The same package ships a local CLI that wraps Claude Code so secrets are redacted before they ever reach Anthropic:

pip install shutapp
shutapp claude            # launches Claude Code through a local redaction proxy

shutapp claude starts a localhost proxy and runs the real claude through it, so API keys and other secrets are swapped for reversible placeholders on the way out and restored locally — Anthropic only ever sees redacted text. It works with both API-key and Claude Max/Pro subscription logins: on a subscription it auto-bridges your OAuth through the proxy (your credentials never leave your machine except to Anthropic, exactly as Claude Code already sends them). Requires Claude Code's claude on your PATH.

shutapp status            # version, vault dir, detector count
shutapp session list      # value-free session stats
shutapp detectors list    # the bundled detector registry
shutapp verify rcpt.json  # offline receipt verification

What it does

  1. Sends your prompt text to the Shutapp API, which replaces PII with reversible placeholders like [EMAIL_ADDRESS_1], [PHONE_NUMBER_1], [API_KEY_1].
  2. You send the redacted text to any LLM using your own key. Shutapp never sees your LLM key and never sees the response.
  3. You call unscan(...) to restore the original values in the LLM's response.

After every scan Shutapp prints a one-line receipt to your terminal:

[shutapp] scan ok · 12ms · EMAIL_ADDRESS x1, PHONE_NUMBER x1 · rcpt_8f3a2b

Install (from PyPI, later)

pip install shutapp

Install (from this monorepo, right now)

pip install -e ./packages/sdk-python

Config

Shutapp(api_key, base_url, receipts, receipt_format, timeout)

  • receipts: "stderr" (default), "stdout", "silent", or a callable fn(receipt_dict) for custom logging.
  • receipt_format: "line" or "block".
  • base_url: override for self-hosted Shutapp (e.g. http://localhost:8080).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

shutapp-2.1.0.tar.gz (90.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

shutapp-2.1.0-py3-none-any.whl (102.7 kB view details)

Uploaded Python 3

File details

Details for the file shutapp-2.1.0.tar.gz.

File metadata

  • Download URL: shutapp-2.1.0.tar.gz
  • Upload date:
  • Size: 90.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.10

File hashes

Hashes for shutapp-2.1.0.tar.gz
Algorithm Hash digest
SHA256 65de1a91ca9d61ec6513601e3afc7bd6874ff2a471b50f2463554d92555f9e2d
MD5 abc8db7b37edd356943f04ca7247bd9e
BLAKE2b-256 32f990acdf21c75cf97b6411775a77d07cb0a2975bb87afab75a6bf92e0128cf

See more details on using hashes here.

File details

Details for the file shutapp-2.1.0-py3-none-any.whl.

File metadata

  • Download URL: shutapp-2.1.0-py3-none-any.whl
  • Upload date:
  • Size: 102.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.10

File hashes

Hashes for shutapp-2.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f68793c51636cffaca383cd706542a0bb848c3cfdd9eca2191af361ab64b52e1
MD5 7c5856746d9bb11da35518022b287861
BLAKE2b-256 72227d3c56cde402ee3e3fa645868e7b7eed071acedbe53222bbc0e44ced53de

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page