🛡️ AutoRedact

Secure, client-side image redaction powered by OCR.

Deploy to Cloudflare

All processing happens 100% in your browser. Your images never touch a server.

• 🔍 Automatic Detection - Finds emails, IP addresses, credit cards, and API keys
• 🎯 Precise Redaction - Uses OCR word-level bounding boxes for accurate redaction
• 🔒 Privacy First - Everything runs locally via Tesseract.js
• 📦 Batch Processing - Process unlimited images at once
• ⚡ ZIP Download - Download all redacted files in one click

# Option 1: NPM (Local Dev)
npm install
npm run dev

# Option 2: Docker (Easiest)
docker run -p 8080:8080 karantdev/autoredact:latest

# Option 3: Docker Compose
docker compose up -d

Open http://localhost:5173 and drop your images.

AutoRedact now supports a fully offline CLI mode using the same powerful engine. (jpg and png support only, for now. PDF support incoming)

# Process a single image
npm run cli -- input.jpg

# Disable specific redactors
npm run cli -- input.jpg --no-emails --no-ips

# Use custom rules
npm run cli -- input.jpg --block-words "Confidential" --custom-regex "Project-\d+"

• React + Vite + TypeScript
• Tesseract.js v6 (OCR)
• JSZip (batch exports)
• Tailwind CSS

src/
├── adapters/     # Interface implementations (Browser/Node)
├── components/   # UI Components
├── core/         # Pure Logic (Regex, Math, Image Proc)
├── hooks/        # Custom Hooks
├── utils/        # Helpers
├── types/        # TS Interfaces
├── cli.ts        # CLI Entry Point
└── App.tsx       # Main Entry

GNU General Public License v3.0

The CLI processes one file at a time. Use a shell loop to process entire folders:

# Process all JPGs in 'input' dir and save to 'output' dir
mkdir -p output
for f in input/*.jpg; do
  npm run cli -- "$f" -o "output/$(basename "$f")"
done

Enable strict blocking for sensitive documents:

npm run cli -- invoice.jpg \
  --block-words "Confidential,SSN,Account" \
  --custom-regex "(?i)account\s*#?\s*\d+" \
  --no-ips # Disable IP scanner if irrelevant to boost speed

Prevent redaction of known internal terms or headers:

npm run cli -- internal-doc.jpg \
  --allowlist "CorpCorp,192.168.1.1,ProjectX"

The Docker API is proxied through nginx and available on port 8080 at /api/. It uses standard detection settings (Emails, IPs, Keys, PII) by default, but is fully configurable via the settings parameter.

👉 View Full API Documentation for detailed usage, schema, and Python/Node.js examples.

curl -X POST http://localhost:8080/api/redact \
  -F "image=@/path/to/doc.jpg" \
  -o redacted.png