GitHub X (Twitter) LinkedIn
← All projects
n8n & Automation

Invoi

Local Docker stack for creating invoices and parsing incoming bills. FastAPI is the only writer; Postgres is the ledger, n8n just calls the API.

RoleDesign + Build StatusOpen source TypeAutomation

Overview

Invoi creates numbered invoices (INV-YYYY-####) with GST math and PDF downloads, and parses uploaded bills into structured data with a confidence score. Everything runs locally with Docker: API on :8000, n8n on :5678.

Key features

  • Numbered invoicesINV-YYYY-#### sequencing with duplicate → 409 protection.
  • GST + PDFsTax math, totals and PDF downloads behind auth.
  • Bill parsingMultipart upload returns vendor, id, amount and 0–1 confidence. Writes nothing.
  • n8n workflowWebhook → Parse → Confidence ≥ 0.5 → Create → Receipt, else Needs review.
  • Header authAll invoice routes need X-API-Key; health stays open.
  • Runs locally.env stays out of git; .env.example is the template.

API reference

ActionRoute
HealthGET /health (no key)
CreatePOST /api/v1/invoices (vendor_name, amount, optional tax_rate)
ParsePOST /api/v1/invoices/parse (multipart field file)
ReadGET /api/v1/invoices/{invoice_no}
PDFGET /api/v1/invoices/{invoice_no}/pdf (header download)
docker compose -f compose.yml up -d --build # API docs: http://localhost:8000/docs # n8n: http://localhost:5678

Stack

FastAPI PostgreSQL n8n Docker PDF

Have a project in mind?

Email me
Have a project? Let's talk