# invoice-x/invoice2data

Extract structured data from PDF invoices

Repository: https://github.com/invoice-x/invoice2data
Canonical: https://ross.abutalabs.com/products/invoice2data
Homepage: https://invoice2data.readthedocs.io/
Language: Python
License: MIT
License Family: permissive
Topics: python, data-mining
Last push: 2026-08-21T20:36:56+00:00

## Health v2 (maintenance only)
Score: 97/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 95, longevity 100
- inputs: {"age_days": 4164, "days_push": 12, "days_rel": 32, "gap_med": 15.0, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2203, forks 554 (observed 2026-08-28T04:06:25.783023+00:00)

## What it is
A Python library and CLI tool that extracts structured data from PDF invoices using pluggable text-extraction backends (including OCR) and YAML/JSON regex templates, with optional AI fallback. Results can be exported as CSV, JSON, or XML, or used to rename PDF files.

## Use cases
- extract structured data from pdf invoices
- automate invoice data entry for accounting
- parse invoice fields like amounts and dates into csv or
- ocr scanned invoices and pull out key values
- batch process a folder of supplier invoices
- rename invoice pdfs based on their content

## When to choose
- you process many invoices with recurring, known layouts that templates can capture
- you want a scriptable Python library or CLI rather than manual data entry
- you need pluggable extraction backends including OCR for scanned documents
- you want structured output (CSV/JSON/XML) for downstream accounting or analysis

## When to avoid
- you need to handle highly varied invoice layouts without writing or maintaining templates
- you want a turnkey GUI invoice-processing product
- your documents are not invoices or similar structured business documents
- you expect out-of-the-box accuracy on arbitrary PDFs without configuration

## Facets
- artifact type: library
- maturity: active
- function: parser, ocr, pdf, etl, data-science
- domain: pdf, files, developer-tools
- platform: python, cli, cross-platform
- tags: invoice-processing, pdf-extraction, template-based, accounting, data-extraction, automation, data-engineering

## Member repositories
- invoice-x/invoice2data (main) score 97

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:25.783023+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:46:45.558540+00:00, confidence not recorded.
  - readme: https://github.com/invoice-x/invoice2data (fetched 2026-08-28T04:06:25.783023+00:00, sha 74cbf6d757a4)
  - registry_pypi: https://pypi.org/pypi/invoice2data/json (fetched 2026-08-29T10:27:33.809029+00:00, sha d65235b9b980)
- Data as of 2026-08-30T08:39:29.467469+00:00.