Develop / Guides

Local tools

Which tools mask personal data on your own computer before a document reaches a model.

Two open-source tools mask documents locally, without the gateway. Both are under the MIT licence. The READMEs on GitHub describe installation and commands.

noirdoc CLI

The Python package noirdoc replaces personal data in PDF, DOCX, XLSX and text locally with placeholders such as <<PERSON_1>>. With a namespace, the placeholders stay the same across several files, and noirdoc reveal puts the original values back on your own machine. This makes the CLI useful when you want to sanitise binary documents (PDF, DOCX, XLSX) beforehand or apply reversible pseudonymisation locally; in the gateway itself, Noirdoc Shield statelessly inspects and redacts inbound text without storing mappings.

Source code and README: github.com/noirdoc-ai/mask-engine

Shell
pip install "noirdoc[full]"
noirdoc redact --namespace client-mueller \
  letter.docx -o letter-masked.docx
noirdoc reveal --namespace client-mueller \
  letter-masked.docx -o letter.docx

Claude Code plugin

The plugin connects the noirdoc CLI with Claude Code. It intercepts reads of protected paths, gives Claude a masked copy and stores responses with placeholders. You put the original values back in your own terminal, outside Claude Code.

Source code and README: github.com/nextaim-de/noirdoc-claude-plugin

Text
/plugin marketplace add nextaim-de/noirdoc-claude-plugin
/plugin install noirdoc@nextaim
/noirdoc:noirdoc-setup

Anthropic SDK & Claude Code and Set up Noirdoc Shield describe how to connect Claude Code through the gateway instead of directly to Anthropic and turn on Noirdoc Shield there.