Skip to main content

reckoner: input records on the left, joined to the companies they name on the right, each line labeled with the reason; one pair stamped REFUSED

reckoner

Give it a list of company names from different sources, and it tells you which ones are the same company, and why. It only merges on proof (a shared ID, or the exact same name once spelling noise is removed), never on a guess, and it writes down a receipt for every merge and every refusal.

pip install reckoner-er

The package is called reckoner-er on PyPI because reckoner there is an unrelated Helm tool, so pip install reckoner installs the wrong thing. The import name and the command are both reckoner. Do not install both packages in one environment. Python 3.9 or newer, no dependencies, ships py.typed.

Terminal recording: reckoner --demo, then reckoner vendors.csv grouping 9 rows into 5 companies, then writing resolved.csv with an entity_id column

From Python

from reckoner import resolve, match

clusters = resolve([
    "GENERAL ELECTRIC CO",
    "General Electric Company",
    {"name": "GE", "cik": "0000040545"},
    {"name": "General Electric", "cik": "40545"},
    "Boeing",
])
for c in clusters:
    print(c.canonical_name, c.members, c.link_confidence)
# General Electric Company (0, 1, 2, 3) 0.99
# Boeing (4,) 1.0

m = match("THE SHERWIN-WILLIAMS COMPANY", "Sherwin Williams Co")
m.matched, m.score, m.method   # (True, 0.6, 'name_exact_normalized')

match({"name": "Meta Platforms, Inc.", "cik": "1326801"},
      {"name": "META PLATFORMS INC", "cik": "907471"}).reasons
# ('identical normalized names but conflicting CIK - refusing to merge',)

Every Cluster carries its members, identifiers, confidence and an explanations sentence for every merge and refusal. Full reference: docs/python-api.md.

From the command line

reckoner --demo                                  # see it work on a built-in example
reckoner vendors.csv                             # CSV, JSON or JSON Lines with a name column
reckoner vendors.csv -f csv -o resolved.csv      # your rows + entity_id, canonical_name, link_confidence
reckoner match "GENERAL ELECTRIC CO" "General Electric Company"   # exit 0 on a match, 1 otherwise

Recognised columns (case-insensitive): name, agency, cik, uei, ein, cage, ticker, domain, source, state. --agency handles government agency names (DoD, EPA, U.S. prefixes). reckoner --help lists every option.

How it decides

How reckoner decides: pass 1 merges on a shared ID; pass 2 links exact normalized names at 0.60 unless the records carry conflicting IDs, in which case it refuses with a reason

  • Identifiers merge first. A shared CIK, UEI, EIN, CAGE, ticker or domain merges two records outright. Registry IDs (CIK, UEI, EIN, CAGE) link at 0.97 to 0.99; reassignable ones (ticker 0.90, domain 0.85) lower.
  • Names link only on an exact match after conservative cleanup. Case, punctuation, &, a leading The, and trailing legal suffixes (Inc, Corp, LLC, L.P., GmbH, plc, ...) are removed. Distinguishing words are never dropped. Such links score 0.60.
  • No fuzzy scoring anywhere. A typo does not match. There is no similarity knob to tune.
  • Conflicting registry IDs block a merge. Same normalized name but different CIKs: refused, with the reason recorded.

On a committed snapshot of real GLEIF legal names (1312 entities, 2922 names), formatting variants resolve at precision 0.966 and recall 0.969. Renames and trade names are not linked, by design. Method and numbers: docs/benchmark.md.

MIT licensed.

Metadata

Release files for reckoner-er 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for reckoner-er 0.3.0
File Size Uploaded Provenance Actions
reckoner_er-0.3.0.tar.gz 98.2 kB With provenance Details for reckoner_er-0.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for reckoner-er 0.3.0
File Interpreter ABI Platform Actions
reckoner_er-0.3.0-py3-none-any.whl Python 3 none any Details for reckoner_er-0.3.0-py3-none-any.whl

Total release size: 121.6 kB

Release files / reckoner_er-0.3.0.tar.gz

Download URL reckoner_er-0.3.0.tar.gz
Size 98.2 kB
Tags Source
SHA-256 checksum
How to use checksums
d3c0f14803916ee5671b4b09f8cd670ec4b5c95ba3f35960d8f35faf8e16bcfa
BLAKE2b-256 checksum
How to use checksums
0f6479cc0a128aad8cbc4efdc0c4056ae4ddda42a3dd4b03de1279dfd343e47c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / reckoner_er-0.3.0-py3-none-any.whl

Download URL reckoner_er-0.3.0-py3-none-any.whl
Size 23.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
474c3141b49fb290ad8491c3c363d1b4a9a2449e09a92fcc1649737dcfb1a672
BLAKE2b-256 checksum
How to use checksums
b8b92ec481d969cb043986c84c05e2b2633ad4385c886ae6a4b272cd749a8c9e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Security for reckoner-er 0.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for reckoner_er-0.3.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.3.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page