README.md

metadata

title: Invoice Reconciler
emoji: 📒
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 4.44.0
python_version: '3.10'
app_file: app.py
pinned: false

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

Invoice Reconciler

Reconcile a source of truth against a QuickBooks export (PDF, Excel, or CSV).

Built with Gradio so the Space can use Gradio-compatible hardware (including ZeroGPU if enabled). The reconciliation engine itself does not require a GPU.

Workflow

1. Upload Source of Truth
2. Upload QuickBooks file
3. Parse & confirm Invoice Number / Gross Amount columns
4. Run reconciliation
5. Review summary + exceptions
6. Download Excel report

Architecture

1. Ingestion — parsers, normalization, field mapping helpers
2. Engine — bidirectional reconciliation (no UI imports)
3. UI / Reporting — Gradio workflow and Excel export

Local run

pip install -r requirements.txt
python app.py

Tests

pip install pytest
pytest