This is a submission for the Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle 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) 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 generatorai_service.py: Local Ollama REST client, Gemma prompt engineer, and Pydantic validationinvoice_parser.py: PyMuPDF native PDF text extraction, Tesseract OCR wrapper, and SHA-256 hashingtests/: 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: