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.

This is the meta package: it installs the whole open stack and keeps import openbooks.pipeline working.

pip install openbooks            # core, statements (with PDF), gateways, tax, 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
Package Reads
openbooks-core the contract, normalisation, balance gates, layout registry, CLI
openbooks-statements bank CSV, OFX, MT940, PDFs, scans
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

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

Status: 0.1, 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.1.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.1.0
File Size Uploaded Provenance Actions
openbooks-0.1.0.tar.gz 6.9 kB With provenance Details for openbooks-0.1.0.tar.gz

Built distribution (wheel)

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

Total release size: 14.1 kB

Release files / openbooks-0.1.0.tar.gz

Download URL openbooks-0.1.0.tar.gz
Size 6.9 kB
Tags Source
SHA-256 checksum
How to use checksums
acad7ab86a3e2e554bea19c2eb0e263c42c3f371d7a46e1e6a3d22c7cb80c08d
BLAKE2b-256 checksum
How to use checksums
8bd65b88555a27ca38bce368998c0daed083c2968ffdc1901b34ae4145f8af20
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 18, 2026.

Transparency log

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

Download URL openbooks-0.1.0-py3-none-any.whl
Size 7.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6fb313436e0b828f7ec64d8b93541656aa171fb7b7936ad6ef3fc6ea99290486
BLAKE2b-256 checksum
How to use checksums
aa8e0d0979cf9af013da3b957f007b0c25de1f964c784771928dc5c28c4c9edb
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 18, 2026.

Transparency log

Security for openbooks 0.1.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.1.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 18, 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.1.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