Skip to content

v1.3.1 — GoldenFlow Integration

Choose a tag to compare

@benzsevern benzsevern released this 03 Apr 21:12

What's New

GoldenFlow Integration

GoldenMatch now integrates with GoldenFlow for automatic data transformation before matching.

pip install goldenmatch[transform]

When GoldenFlow is installed, it runs automatically in the dedupe pipeline after GoldenCheck validation and before autofix:

ingest -> GoldenCheck (validate) -> GoldenFlow (transform) -> autofix -> standardize -> match

GoldenFlow handles format normalization that neither GoldenCheck nor GoldenMatch's autofix addresses:

  • Phone numbers (15 formats -> E.164)
  • Dates (MM/DD/YYYY vs YYYY-MM-DD -> ISO 8601)
  • Address abbreviations
  • Categorical misspellings (fuzzy matching)
  • Unicode normalization, smart quotes

Config

transform:
  enabled: true
  mode: announced  # "announced" | "silent" | "disabled"

Or zero-config: if goldenflow is installed, it runs automatically.

Safety

  • Graceful degradation: if goldenflow crashes, logs a warning and continues with untransformed data
  • Warns when config enables transforms but goldenflow is not installed
  • Uses logger (not print) for safe operation in REST/MCP/agent contexts

Full Changelog: v1.3.0...v1.3.1