Installation

pip install goldenmatch

GOLDENMATCH_NATIVE=0            # disable the native kernel entirely
GOLDENMATCH_PLANNER_BUCKET=0    # force the polars-direct backend

pip install goldenmatch[polars]         # optional COMPATIBILITY extra: the classic GOLDENMATCH_FRAME=polars lane + kernel-absent golden replay + cell-quality weighting. NOT needed for speed -- the polars-free install measures faster (the Rust kernels carry the hot paths).
pip install goldenmatch[embeddings]     # sentence-transformers + FAISS
pip install goldenmatch[llm]            # Claude/OpenAI for LLM scoring
pip install goldenmatch[postgres]       # PostgreSQL database sync
pip install goldenmatch[snowflake]      # Snowflake connector
pip install goldenmatch[bigquery]       # BigQuery connector
pip install goldenmatch[databricks]     # Databricks connector
pip install goldenmatch[salesforce]     # Salesforce connector
pip install goldenmatch[duckdb]         # DuckDB out-of-core backend
pip install goldenmatch[quality]        # GoldenCheck data quality scanning
pip install goldenmatch[ray]            # Ray distributed backend

pip install goldenmatch[embeddings,llm,postgres]

docker pull ghcr.io/benseverndev-oss/goldenmatch:latest

# Run a dedupe
docker run --rm -v $(pwd):/data ghcr.io/benseverndev-oss/goldenmatch:latest \
    dedupe /data/customers.csv --output-dir /data/results

# Start the REST API
docker run --rm -p 8080:8080 -v $(pwd):/data ghcr.io/benseverndev-oss/goldenmatch:latest \
    serve /data/customers.csv --port 8080

# Debian/Ubuntu
sudo dpkg -i goldenmatch-pg-0.7.0-pg16-amd64.deb
sudo systemctl restart postgresql

# RHEL/Fedora
sudo rpm -i goldenmatch-pg-0.7.0-pg16.x86_64.rpm
sudo systemctl restart postgresql

cosign verify-blob \
  --bundle goldenmatch_pg-0.7.0-pg17-linux-x86_64.tar.gz.sigstore \
  goldenmatch_pg-0.7.0-pg17-linux-x86_64.tar.gz \
  --certificate-identity-regexp 'github.com/benseverndev-oss/goldenmatch' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

pip install goldenmatch-duckdb

import duckdb, goldenmatch_duckdb

con = duckdb.connect()
goldenmatch_duckdb.register(con)
con.sql("SELECT goldenmatch_score('John', 'Jon', 'jaro_winkler')")

packages:
  - git: "https://github.com/benseverndev-oss/goldenmatch.git"
    subdirectory: "packages/dbt/goldensuite"

{{ config(materialized='goldenmatch_dedupe', probabilistic=true) }}
SELECT * FROM {{ ref('stg_customers') }}

goldenmatch info
# Shows version, Python, and installed extras

goldenmatch demo
# Runs a built-in demo with sample data

import goldenmatch as gm
print(gm.__version__)   # "2.8.0"

goldenmatch setup