FreelanceFlow AI

A developer built FreelanceFlow AI, a fully local, privacy-first invoice and expense manager for freelancers that extracts structured, categorized expense records from PDF invoices and receipt images. The app runs a Google Gemma model through Ollama for extraction, uses PyMuPDF and Tesseract OCR for parsing, and stores results in a SQLite database with parameterized queries, SHA-256 duplicate checks, and Pydantic validation, backed by 13 passing unit tests. It was submitted to the Hacktoberfest 2026 Week 2 Side Hustle challenge.

This is a submission for the Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle https://dev.to/challenges/hacktoberfest-week2-2026-10-12 FreelanceFlow AI is a 100% local, privacy-first invoice and expense manager designed specifically for freelancers, solopreneurs, and independent contractors. At the end of every month or tax season, freelancers face a painful chore: hunting down dozens of digital receipts and PDF invoices scattered across email inboxes and downloads folders GitHub Copilot, Figma, AWS, Vercel, WeWork, Zoom, client dinners, and hardware purchases . Today, they have two frustrating choices: Freelancers and solopreneurs running lean side hustles who care deeply about: The app features a modern, responsive SaaS-style interface powered by Streamlit and Plotly: A ready-to-test sample invoice sample invoice.pdf https://github.com/snehalghadge59-blip/freelanceflow-ai/blob/main/sample invoice.pdf is included in the repository. Built for the Hacktoberfest 2026 Week 2 Side Hustle challenge devchallenge, hf26challenge . FreelanceFlow AI is a 100% local, privacy-first invoice and expense manager designed specifically for freelancers, solopreneurs, and contractors. It turns messy PDF invoices and receipt images into structured, categorized tax-ready expense records using a locally running Google Gemma model served through Ollama and a local SQLite database. As a freelancer, keeping track of deductible business expenses usually means juggling PDF receipts, taking screenshots of SaaS invoices, and spending hours each quarter manually typing numbers into spreadsheets. Cloud AI alternatives exist, but they have major drawbacks: The repository includes the full source code, test suite, and Windows setup instructions: app.py : Modern SaaS UI, interactive charts, and review forms database.py : Parameterized SQLite queries, duplicate hash checks, and demo data generator ai service.py : Local Ollama REST client, Gemma prompt engineer, and Pydantic validation invoice parser.py : PyMuPDF native PDF text extraction, Tesseract OCR wrapper, and SHA-256 hashing tests/ : 13 passing unit tests verifying ACID compliance, Pydantic normalization, and document parsing FreelanceFlow AI is built entirely on open-source technologies and local-first architecture: