BillSnap：自由工作者私隱優先的本地發票及收據擷取工具

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

What I Built

I built BillSnap to solve a critical problem faced by freelancers and independent contractors: sorting through piles of messy invoices, client receipts, and tax deductions without leaking sensitive financial data to expensive cloud SaaS platforms.

BillSnap is a local-first, privacy-focused micro-SaaS tool designed for freelancers:

• Instant Optical Extraction: Drag and drop photos or PDFs of receipts, client invoices, and bank statements.
• 100% Local Financial Parsing: Runs lightweight open-weight vision models locally to extract vendor names, dates, tax amounts, line items, and currencies directly on the user's device.
• Zero Data Leakage: Keeps client billing details, bank balances, and tax records completely off third-party AI servers.
• One-Click Export: Organizes transactions into structured CSV, JSON, and QuickBooks-compatible formats for accounting.

I gave the build to my friend Rohan, a freelance UI/UX designer who was stressing over tracking his quarterly expenses. He dropped 42 mixed PDF receipts and physical receipt photos into BillSnap. It parsed and categorized every transaction in under 45 seconds locally with 0 cloud calls. He offered to pay a one-time $15 license on the spot, saying: "I stopped using online PDF converters because of NDAs. Having this run offline on my laptop is an immediate buy."

How I Built It

The core philosophy behind BillSnap is keeping operational costs at $0 so the micro-SaaS remains profitable while giving users total data privacy.

   +-------------------------------------------------------+
   |               Freelancer / Small Business             |
   |             (Uploads Invoice or Receipt Photo)        |
   +---------------------------+---------------------------+
                               |
                               v
   +-------------------------------------------------------+
   |               FastAPI + Web Application               |
   |                (Hosted on Render / Local)             |
   +-------+-------------------+-------------------+-------+
           |                   |                   |
           v                   v                   v
  +-----------------+  +---------------+  +-------------------+
  | Gemma 2 /       |  | SQLite /      |  | Local Export      |
  | PaliGemma Nano  |  | Local Expense |  | Engine (CSV /     |
  | Vision Parser   |  | Store         |  | JSON Formatters)  |
  +-----------------+  +---------------+  +-------------------+

Technical Stack:

• Vision Intelligence (PaliGemma / Gemma 2 Vision via Ollama): Extracts key-value pairs, vendor details, totals, and line items from unstructured receipt images and PDFs.
• Local Database (SQLite): Stores categorized expense logs locally without external cloud sync requirements.
• Backend Framework (Python FastAPI): Lightweight API processing requests and file uploads asynchronously.
• Deployment & Monitoring (Render & Sentry): Hosts the web interface container and monitors local parsing execution traces.

Why Does Open Innovation Matter?

1. Uncompromised Financial Privacy: Freelancers handle confidential client billing details and personal tax information. Running open-weight vision models locally ensures sensitive financial records never touch proprietary third-party training servers.
2. Zero Per-Document API Costs: Proprietary OCR and vision APIs charge per page processed, making a cheap expense-tracking micro-SaaS unit economics unprofitable. Open-weight models allow infinite local processing for $0 recurring cost.
3. Model Customizability: Open weights enable fine-tuning specifically for regional tax formats (such as GST, VAT, or local receipt templates) that general-purpose commercial APIs frequently misread.

Prize Categories

• Best Use of Gemma: Uses Gemma 2 / PaliGemma open vision models for document extraction and line-item categorization.
• Best Use of Render: Hosts the FastAPI backend application, web interface, and background processing container on Render.
• Best Use of Sentry Agent Tracing: Tracks local model extraction latency, token usage, and tool pipeline performance.