bib-ami 0.12.0

A command-line tool for improving the integrity of BibTeX bibliographies

bib-ami

A Bibliography Integrity Manager

bib-ami is a command-line tool for improving the integrity of BibTeX bibliographies. It automates a critical data cleaning and entity resolution workflow by consolidating multiple .bib files, validating every entry against the CrossRef API to establish a canonical DOI, and then deduplicating records based on this verified identifier.

The tool intelligently categorizes entries as 'verified' or 'suspect', enabling researchers to build a clean, reliable, and auditable bibliography for their LaTeX, Zotero, or JabRef workflows.

Key Features

• Merge & Consolidate: Combines multiple .bib files from a directory into a single source.
• Validate & Enrich: Validates every entry against the CrossRef API to find and correct its canonical DOI.
• Deduplicate with Confidence: Uses verified DOIs as the primary key for accurate deduplication, with a fuzzy-matching fallback for entries without a DOI.
• Intelligent Triage: Automatically separates high-confidence, verified records from questionable ones that require manual review.
• Audit Trail: Provides transparent reporting on the actions taken to clean the bibliography.

Getting Started

1. Installation

Ensure you have Python 3.7+ installed. You can install bib-ami using pip:

pip install bib-ami

2. Quick Start

To process a directory of .bib files, run the following command. You must provide an email address for the responsible use of the CrossRef API.

bib-ami --input-dir path/to/your/bibs --output-file cleaned.bib --suspect-file suspect.bib --email "[e-mail]"

This will produce two files:

• cleaned.bib: Contains the verified and accepted entries.
• suspect.bib: Contains entries that could not be verified and require manual review.