Reconify Docs

Create a Config

Build a reconify.yaml file with sources, parsers, pairs, and index settings.

Create reconify.yaml at the root of the workflow directory.

Minimal shape

version: 1
timezone: "UTC"

sources:
  bank:
    file_pattern: "data/bank.csv"
    parser:
      type: csv
      date_col: "Date"
      date_layout: "2006-01-02"
      amount_col: "Amount"
      decimal: "."
      thousands: ","
      multiplier: 100
      ref_col: "Reference"
      name_col: "Description"

  ledger:
    file_pattern: "data/ledger.csv"
    parser:
      type: csv
      date_col: "posted_at"
      date_layout: "2006-01-02"
      amount_col: "amount_minor"
      multiplier: 1
      ref_col: "payment_id"
      name_col: "memo"

pairs:
  bank_vs_ledger:
    left: bank
    right: ledger
    date_window: "1d"
    amount_tolerance_minor: 0
    name_mode: "none"

Add index settings

index:
  backend: auto
  spill_dir: "/tmp/reconify"
  auto_max_right_file_mb: 2048

Use auto when the right file can become large. Reconify uses the disk index when the right file exceeds the threshold.

Validate

reconify config validate --config reconify.yaml

Validation catches missing required fields, unknown sources in pairs, invalid parser types, invalid timezones, invalid date window units, and negative tolerances.

On this page