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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.