DEV Community

Dien
Dien

Posted on

HustleLedger AI — Privacy-First Financial Sentinel & Scope Defender for Side Hustlers

#devchallenge #hf26challenge #sidehustle #python

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

What I Built

Every side hustler and freelancer faces the same triple threat:

  1. Expensive accounting SaaS fees ($30–$50/mo) eating up precious early margin.
  2. Leaking confidential client rates and bank transactions to proprietary third-party cloud data-miners.
  3. Losing money to unpaid scope-creep and overdue invoices because drafting firm boundary emails feels awkward and confrontational.

I built HustleLedger AI: a 100% local-first, zero-dependency financial sentinel and negotiation companion designed for freelancers, creators, and micro-consultants.

Key Capabilities:

  1. 🧾 Expense Tax Shield: Instantly categorizes receipts (cloud hosting, hardware gear, client coffee meetings, home utilities) into recognized freelance tax deduction categories (100% vs 50% write-offs) and calculates real cash kept in your pocket.
  2. 📄 Instant Client Invoice Builder: Generates structured, verified client billing statements with automatic itemization and standard Net 14 terms with zero subscription overhead.
  3. 🛡️ Scope-Creep & Overdue Defender: Interfaces with Google's Gemma open-weight AI to draft diplomatic yet rock-firm overdue invoice reminders and professional boundaries when clients ask for extra unpaid work.

Demo

You can also run it locally with zero pip installs:

git clone https://github.com/dieennn/hacktoberfest-2026.git
cd hacktoberfest-2026
python main.py
# Open http://localhost:8080/week-2/
Enter fullscreen mode Exit fullscreen mode

Code

The full project is open-source and part of my unified Hacktoberfest 2026 monorepo:

GitHub logo dieennn / hacktoberfest-2026

🎃 Hacktoberfest 2026 — DEV Challenges Monorepo

🎃 Hacktoberfest 2026 — DEV Challenges Monorepo

Repository containing project submissions for the Hacktoberfest 2026 DEV Challenges ("AI belongs to everyone").
Built by @dieennn.

📁 Repository Structure










































Round Challenge Theme Folder / Project Status

Launch Weekend (Oct 2 - Oct 5)		 Build for a Friend 00-weekend-allergy-guard ✅ Completed

Week 1 (Oct 5 - Oct 12)		 Touch Grass 01-week-1 ✅ Completed

Week 2 (Oct 12 - Oct 19)		 Side Hustle 02-week-2 ✅ Completed

Week 3 (Oct 19 - Oct 26)		 Announced Oct 19 03-week-3 ⏳ Upcoming

Week 4 (Oct 26 - Nov 1)		 Announced Oct 26 04-week-4 ⏳ Upcoming

🚀 Projects Overview

00-weekend-allergy-guard — Allergy & Diet Guard (SafeBite AI)

  • Theme: Build for a Friend
  • Problem: Protect friend Sarah (severe peanut allergy, celiac disease, and lactose intolerance) from hidden allergens (arachis oil, seitan, casein) and cross-contamination when eating out.
  • Tech: Local Python 3…
View on GitHub

Directory: 02-week-2/

How I Built It

1. Zero External Dependencies (Standard Library Architecture)

When running a side hustle, every dollar and millisecond matters. HustleLedger relies strictly on the Python 3 standard library (http.server, socketserver, json, urllib). No bloated virtual environments, no node_modules, and instant startup on any machine.

2. Google Gemma Open-Weight AI Integration

HustleLedger bridges to Google's Gemma open-weight models (gemma2:2b) running via local Ollama inference (http://localhost:11434/api/generate). When negotiating sensitive client boundaries or collecting overdue payments, Gemma drafts polite, assertively professional messages tailored to the exact dollar amount and context.

3. Bulletproof Offline Fallback

If Ollama is not active, the system automatically degrades to deterministic, tested communication heuristics and tax deduction tables (EXPENSE_TAXONOMY). The application functions continuously offline without cloud latency or failure points.

Why Open Innovation Matters for Side Hustlers

  1. Complete Financial Privacy: Client agreements and billing numbers never leave your local machine or trusted deployment.
  2. Zero Recurring Tool Tax: Solopreneurs keep 100% of their earnings instead of paying recurring subscription fees to SaaS platforms.
  3. Resilience & Autonomy: Open-weight models empower independent makers to own their intellectual property and business workflows without vendor lock-in.

Prize Categories

  • Hacktoberfest Open-Source AI Challenge: Week 2 (Theme: Side Hustle)
  • Best Use of Render: Deployed as an integrated micro-route on Render's free tier gateway monorepo.
  • Best Use of Gemma: Integrated Google's open-weight Gemma model to assist freelancers in business negotiation and scope protection.

Top comments (0)