GoldenCheck

Data validation that discovers rules from your data so you don’t have to write them.

PyPI Downloads CI Python 3.11+ Tests


Every other data validation tool makes you write rules first. GoldenCheck flips it: validate first, keep the rules you care about.

DQBench Score: 88.40

Tool Mode Score
GoldenCheck zero-config 88.40
Pandera best-effort rules 32.51
Soda Core best-effort rules 22.36
Great Expectations best-effort rules 21.68

GoldenCheck’s zero-config discovery outperforms every competitor — even when they have hand-written rules.

How It Works

1. SCAN     →  goldencheck data.csv
               Profiles your data and discovers what "healthy" looks like

2. REVIEW   →  Interactive TUI shows findings sorted by severity
               Each finding has: description, affected rows, sample values

3. PIN      →  Press Space to promote findings into permanent rules
               Dismiss false positives — they won't come back

4. EXPORT   →  Press F2 to save rules to goldencheck.yml
               Human-readable YAML with your pinned rules

5. VALIDATE →  goldencheck validate data.csv
               Enforce rules in CI with exit codes (0 = pass, 1 = fail)

Quick Install

pip install goldencheck
goldencheck data.csv

Documentation

Guide Description
Installation Install GoldenCheck and optional extras
Quick Start Get started in 60 seconds
CLI Reference 14 commands, flags, and exit codes
Interactive TUI 4-tab interactive terminal interface
Profilers 10 column + 4 cross-column profilers
Configuration goldencheck.yml reference
Domain Packs Healthcare, finance, e-commerce type definitions
Schema Diff Compare data versions, detect drift
Auto-Fix Automated data cleaning
Watch Mode Continuous directory monitoring
REST API HTTP microservice
Database Scanning Scan Postgres, Snowflake, BigQuery directly
Scheduled Runs Cron-like scheduling with webhooks
LLM Boost LLM-enhanced validation (~$0.01/scan)
MCP Server Claude Desktop integration (9 tools)
Jupyter & Colab Rich HTML display in notebooks
GitHub Action CI integration with PR comments
Benchmarks Speed tests and DQBench results
Architecture Module layout and data flow

Part of the Golden Suite: GoldenMatch · dbt-goldencheck · goldencheck-types · goldencheck-action