Professional, Local-First Document Redaction.
Marcut is a native macOS application for legal and professional document redaction. It combines a deterministic rules engine with optional local AI (Ollama) to identify and redact sensitive information (PII) from Microsoft Word (.docx) documents, producing "Track Changes" redlines plus JSON audit and scrub reports.
- Local-First & Private: All processing happens on your device. No cloud uploads.
- Self-Contained Runtime: Embedded Python (BeeWare) and local AI service; no system installs required.
- Dual-Engine Power:
- Rules Engine: Instant, regex-based detection for structured data (SSN, Phone, Email, etc.).
- AI Engine: Context-aware entity recognition (Names, Organizations) using local Ollama models.
- Professional Output: Generates standard DOCX review artifacts with redacting edits marked as "Track Changes"; review and accept changes before external sharing.
- Audit Ready: Produces JSON redaction reports and metadata scrub reports for verification; reports may include raw detected text and document metadata.
- App Store Ready: Fully sandboxed and code-signed architecture.
- User Guide: Installation, usage instructions, and troubleshooting.
- Developer Guide: Deep dive into the Swift+PythonKit architecture, build system, and contribution workflow.
- Technical Architecture: High-level system design and component interaction.
- Security Policy: Vulnerability reporting and security model.
To build Marcut from source (macOS required):
-
Clone the repository:
git clone https://github.com/legalmarc/marcut.git cd marcut -
Configure: Copy the example config and edit if needed (mostly for signing identities).
cp build-scripts/config.example.json build-scripts/config.json
-
Build: Use the TUI orchestrator (single entrypoint) to create a local dev build.
./build_tui.py
Then choose Build Workflows → Dev Fast + Test Prep.
-
Run: Launch the built app:
open src/swift/MarcutApp/.build/arm64-apple-macosx/debug/MarcutApp
For detailed build instructions, see the Developer Guide.
We welcome contributions! Please see CONTRIBUTING.md for guidelines on code style, testing, and the pull request process.
This project is licensed under the MIT License - see the LICENSE.txt file for details.
Built with SwiftUI, PythonKit, BeeWare, and local Ollama.