Skip to main content

openbooks

Financial documents in, one proven JSON document per file out, or a typed refusal. Never guessed. Never partially released.

Open Books reads bank statements, payment-gateway exports and tax documents into a canonical openbooks.v1 record. A file is released only if its numbers prove themselves (balances tie, totals match, and at least one check is independent evidence from the document itself); otherwise it is refused with a typed code. Every released field keeps its evidence: page, bounding box, row, raw text and extraction method. Money is Decimal end to end and nothing is rounded silently.

pip install openbooks            # every layout, PDFs with a text layer, doctor
pip install "openbooks[scan]"    # adds OCR for scans and the typed heads (EasyOCR, PyTorch, Pillow)
openbooks doctor
openbooks run statement.csv --currency INR --opening 1000.00 --out out
from decimal import Decimal
from pathlib import Path

from openbooks import Params, process

doc = process(Path("statement.csv"), Params(currency="INR", opening=Decimal("1000.00")))
print(doc["status"], doc.get("error"))   # a refusal is a value, not an exception

Everything is in this one package:

Module Reads
openbooks.core the contract, normalisation, balance gates, layout registry, CLI
openbooks.statements bank CSV, OFX, MT940, PDFs; scans with [scan]
openbooks.gateways Stripe, Razorpay, PayPal, Wise
openbooks.tax Form 26AS, AIS, FIRA, Form 1099-B, trial balance
openbooks.doctor installation, provider and model-integrity checks

Until 0.1.0 these were six separate packages (openbooks-core, openbooks-statements, openbooks-gateways, openbooks-tax, openbooks-doctor and this one as a meta package). After upgrading, openbooks doctor tells you how to remove the old ones.

Exit codes: 0 everything released, 1 something was refused, 2 usage error, 3 the engine could not run.

Status: 0.2, pre-release. Every layout has been exercised on synthetic fixtures only, not on real exports, and PayPal, Wise and all the tax layouts are experimental. Do not rely on it for real filings.

Licence: Apache-2.0.

Metadata

Release files for openbooks 0.2.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 openbooks 0.2.0
File Size Uploaded Provenance Actions
openbooks-0.2.0.tar.gz 18.2 MB With provenance Details for openbooks-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for openbooks 0.2.0
File Interpreter ABI Platform Actions
openbooks-0.2.0-py3-none-any.whl Python 3 none any Details for openbooks-0.2.0-py3-none-any.whl

Total release size: 36.5 MB

Release files / openbooks-0.2.0.tar.gz

Download URL openbooks-0.2.0.tar.gz
Size 18.2 MB
Tags Source
SHA-256 checksum
How to use checksums
381e98187183699beea8204124088bbb5dd47f6a5b96ff1ff4dc02878e20b90e
BLAKE2b-256 checksum
How to use checksums
dd623c1e47274085f697ab94f8e2e16ac7925a06eb67eb376a3a2ce4089c24a9
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 19, 2026.

Transparency log

Release files / openbooks-0.2.0-py3-none-any.whl

Download URL openbooks-0.2.0-py3-none-any.whl
Size 18.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
ba5f68811a39c24b8165176a9a9d7bf246154de25418ebd2f453f8c40dc03cde
BLAKE2b-256 checksum
How to use checksums
463d2a3dc366699b8109ebeb594204e5e5f87a8574d82efa988edd634ba9b827
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 19, 2026.

Transparency log

Security for openbooks 0.2.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 openbooks-0.2.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 19, 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.2.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