ai-data-scrubber 0.1.1

A lightweight tool for removing personal data from text before uploading to LLMs

AI Data Scrubber

The AI Data Scrubber is a lightweight privacy-focused tool designed to remove personal information from text documents before uploading them to Large Language Models (LLMs). You can use it to clean sensitive documents like resumes or contracts. It's not guaranteed to remove everything, so you should still check before you upload your file to a LLM.

It uses a mixture of regular expressions and named entity recognition models from spaCy. It's less accurate than asking a LLM to remove PII - but then you don't need to either run a LLM on your own machine, or upload your document to a LLM.

What It Does

The AI Data Scrubber removes personal information including:

• Names
• Email addresses
• Phone numbers
• Street addresses & ZIP codes
• URLs
• License plates

Currently, only US formats are supported.

You can run it via a command line interface or you can import it into your Python script.

Quick Start

# Install using pip
pip install ai-data-scrubber

# Download required language model (~560MB)
python -m spacy download en_core_web_lg

# Clean your file
ai-data-scrubber your-file.txt

Usage

Command Line:

# Auto-generates an output file with _scrubbed suffix
ai-data-scrubber input.txt

# Or you can specify the output file with the -o flag
ai-data-scrubber input.txt -o output.txt

Python:

from ai_data_scrubber import scrub_text, scrub_file

# Scrub text directly
cleaned = scrub_text("Your text with personal information here")

# Or scrub a file
scrub_file("input.txt", "output.txt")

Example

Original text:

John Smith
123 Main Street, Apt 4B
New York, NY 10001
Email: [e-mail]
Phone: [phone]

Cleaned text:

[NAME]
[ADDRESS], [UNIT]
New York, NY [ZIP_CODE]
Email: [EMAIL]
Phone: [PHONE]

Documentation

You can find further documentation in the docs folder:

• Installation Guide - Detailed installation including from source
• Performance Testing - How to run a testing script with 20 sample resumes

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions welcome! Feel free to submit a Pull Request.