This is a submission for the Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle
What I Built
HustleVault AI is a sovereign, local-first financial intelligence copilot and ledger engine built specifically for freelancers, indie hackers, and side-hustlers.
Freelancers and micro-entrepreneurs lose money in two big ways:
- Recurring SaaS Tax: Traditional cloud accounting software (QuickBooks, FreshBooks, Xero) charges $20–$50/month, taking a painful bite out of early side-hustle revenue.
- Privacy Risks: Financial accounting data, client invoices, and billing specifics are highly sensitive. Uploading them to closed cloud LLMs exposes sensitive client pricing, tax brackets, and proprietary financial histories.
HustleVault AI solves this completely. It runs a local open-weight model directly on the user's hardware via Ollama. You paste messy bank transaction memos, Upwork alerts, or receipt notes, and the local AI extracts structured accounting records, estimates CPA-compliant write-offs, and manages an offline SQLite ledger—with zero recurring subscription fees and zero cloud leakage.
Demo
The application features a responsive, dark-mode financial command center:
- Local Real-Time Dashboard: Instant live metrics tracking Gross Income, Operating Expenses, Net Profit, and Tax Write-Offs (estimated 25% tax bracket savings).
- Zero-Cloud AI Intake: Paste any raw memo (e.g., "Paid $180 to freelancer Alex on Upwork for logo vectorization"), and the local open-weight model extracts the Vendor/Client, Amount, Currency, Category, and Tax Deductibility with an auditing rationale.
- Audited Ledger & CSV Export: Direct SQLite persistence with live search, project filtering, and one-click CSV export ready for tax season.
Code
The full source code, minimal dependencies, and automated test suite are 100% open source under the MIT License:
HustleVault AI ⚡
A local-first, zero-cloud financial intelligence & ledger copilot tailored for freelancers, indie hackers, and side-hustlers.
Built for the Hacktoberfest Open-Source AI Challenge: Side Hustle.
Eliminates recurring SaaS accounting fees (QuickBooks, Expensify) and safeguards confidential client billing data by running deterministic accounting extraction locally using open-weight models (Ollama: Qwen 2.5 / Llama 3.2). Verified with local Qwen 2.5 live inference.
✨ Features
- 🧠 Natural Language Intake: Paste chaotic invoices, bank SMS alerts, or memo notes (e.g., "Paid $45 to Vercel for Pro hosting of client app").
- 🔒 Zero-Cloud Privacy: 100% on-device inference via local Ollama. No third-party LLM API keys. No data leaks.
- 📐 Deterministic JSON Schema Extraction: Guarantees strict parsing of Type, Counterparty, Normalized Amount, Currency, Category, Tax-Deductibility status, and CPA justification.
- 📊 Real-time Financial Metrics: Live KPI dashboard tracking Gross Income, Operating Expenses, Net Freelance Profit, and Identified Tax Write-Offs.
- 🗄️ ACID SQLite Persistence:…
Quickstart:
bash
# Clone the repository
git clone [https://github.com/fokrulanthro16-eng/hustlevault-ai.git](https://github.com/fokrulanthro16-eng/hustlevault-ai.git)
cd hustlevault-ai
# Install minimal dependencies
pip install -r requirements.txt
# Run local Ollama model
ollama run qwen2.5:latest
# Start HustleVault AI
python app.py
Visit http://localhost:8000 to access the local dashboard.
How I Built It
HustleVault AI was engineered with an offline-first, local-inference architecture:
Open-Weight Intelligence: Powered by Qwen 2.5 running locally via Ollama. The system uses deterministic system prompts and strict JSON schema enforcement to ensure structured accounting extraction without hallucinated commentary.
Backend Architecture: Built with Python and FastAPI, backed by local SQLite for zero-latency, private, and ACID-compliant transaction persistence.
Resilient Fallback Engine: Features an intelligent heuristic fallback mechanism. If the local Ollama instance is temporarily suspended, the system gracefully continues parsing expenses without halting user operations.
Frontend Command Center: A lightweight, dependency-free single-page dashboard built with modern Tailwind CSS, Lucide Icons, and Vanilla JavaScript, served directly by FastAPI.
Why Does Open Innovation Matter?
Open innovation and open-weight AI models are the only foundation upon which true financial privacy can be guaranteed.
Closed-source proprietary APIs operate on subscription billing, usage meters, and data collection policies that conflict with accounting security. If a solo founder has to pay $0.05 per API call to log an expense, the economics of tracking micro-transactions break down.
With open-weight models like Qwen 2.5 and open tooling like Ollama:
Economic Viability: Zero inference marginal cost allows solo builders to run millions of extractions for free on their existing hardware.
Uncompromising Confidentiality: Client contract amounts, invoices, and expense notes never leave the local machine.
Software Longevity: The software will continue to operate reliably even without an internet connection, shielding developers from arbitrary API depreciation or pricing hikes.
My First User
I tested HustleVault AI on real client project expenses accumulated over the past month across Upwork contractor fees, cloud domain renewals, and API compute costs.
The immediate value proposition was evident: categorizing 15+ mixed transactions took under 20 seconds of copy-pasting, automatically uncovering over $400 in tax-deductible write-offs without sending a single byte to an external server. That immediate ROI is something any active freelancer would pay a one-time license fee to own permanently.
Prize Categories
Best Use of Gemma (Compatible with local Gemma 2 instances through the same Ollama runtime)
Best Use of DigitalOcean / Render (Ready for one-click private VPS deployment)
Top comments (0)