ReceiptFlow AI: The Zero-Cloud, Local-First Receipt Sorter for Freelancers

Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle Submission 💸

This is a submission for the Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle

Every tax season or quarterly review, I found myself facing the same chaotic chore: a desktop folder cluttered with scattered PDF invoices, train ticket receipts, cloud subscription receipts, and equipment purchases.

When I looked for tools to automate this, I ran into two big dealbreakers:

I built ReceiptFlow AI to solve my own problem first—and package it as a clean, viable side-hustle product that other freelancers and indie builders would gladly pay for.

ReceiptFlow AI is a 100% local, privacy-first receipt and invoice organizer. Documents are parsed on-device using open-weight models powered by Ollama ( gemma2:2b for embedded text and llava:7b for images). The frontend keeps all metadata inside the browser's IndexedDB, and clean CSV exports are generated client-side.

No cloud databases. No monthly API bills. Zero documents ever leave the machine.

Here is the high-level data flow of how ReceiptFlow AI operates completely offline:

flowchart TD A[Drop receipt PDF / Image] --> B[React Upload Queue] B --> C[POST 127.0.0.1:8000/api/receipts/parse] C --> D{File Format} D -->|PDF| E[PyMuPDF In-Memory Text Extraction] D -->|Raster Image| F[In-Memory Base64 Buffer] E --> G[Local Ollama: gemma2:2b] F --> H[Local Ollama Vision: llava:7b] G --> I[Defensive JSON Sanitization & Pydantic Validation] H --> I I --> J[Structured Record returned to Browser] J --> K[User Review & Inline Correction] K --> L[Browser IndexedDB Storage via idb] L --> M[Local Sanitized CSV Export] Highlights of the User Experience: Instant Engine Telemetry: Real-time indicator displaying local Ollama reachability and active model ( LOCAL ENGINE ONLINE / ENGINE OFFLINE ). Drag-and-Drop Batch Processing: Drop multiple files (PDF, PNG, JPG, JPEG, WEBP) simultaneously with live processing queue indicators. Smart Analytics: Real-time expense totals, calculated tax breakdowns, and animated SVG sparklines.

Review & Inline Correction: A clean modal editor to verify and fine-tune model outputs before committing them to records. Formula-Injection Safe CSV Export: Exports compliant CSV files with automated protection against spreadsheet formula injection ( =, @, +, - ). Code The complete codebase is open source and available on GitHub:

ReceiptFlow AI is a privacy-first, offline-first receipt and invoice organizer for freelancers. Documents are processed by a local FastAPI service that calls Ollama on your own machine. The browser stores extracted records in IndexedDB; CSV export is generated locally.