---
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

```bash
pip install -r requirements.txt
python app.py
```

## Tests

```bash
pip install pytest
pytest
```