Skip to content

Manual install

If you can’t or don’t want to pipe a remote script into a shell, install manually.

1. Install uv

uv is a Python package manager that handles isolated tool installs. Install per its official instructions — it’s a single binary, no system Python touched.

2. Verify the wheel

The latest release’s SHA256 is on the changelog page and inside /version.json for the in-app updater.

Terminal window
pip download --no-deps docs-anonymizer
shasum -a 256 docs_anonymizer-*.whl

Compare to the published SHA256.

3. Install

Terminal window
uv tool install docs-anonymizer

4. Optional OCR for scanned PDFs

Scanned and hybrid PDFs require system Tesseract with English and Russian language packs. Skip this step if you only process DOCX/XLSX and PDFs with a text layer.

Terminal window
# macOS
brew install tesseract tesseract-lang
# Ubuntu / Debian
sudo apt install tesseract-ocr tesseract-ocr-eng tesseract-ocr-rus
# Windows PowerShell
winget install UB-Mannheim.TesseractOCR

Verify:

Terminal window
anonymize doctor --no-network

5. Run

Terminal window
anonymize

The first run downloads spaCy + Natasha language models (≈ 1.2 GB combined). Subsequent launches are instant.

Offline-only environments

See Corporate setup for the airgap-friendly workflow: mirror PyPI behind a corporate index, point uv at it via UV_INDEX_URL.