Solodesk-Ai

What I Built SoloDesk AI is a privacy-first, zero-marginal-cost financial copilot and invoice intelligence engine built for freelancers, consultants, and solo agency founders. Powered by Google Gemma 2 open weights, it runs 100% locally on your computer with zero cloud data leakage and zero recurring API costs.

Who Would Pay For It & Why? Freelancers run tight margins and have zero room for administrative leakage:

The Scope Creep & Billing Leak Epidemic: Up to 15–20% of billable time slips through the cracks—unbilled "quick revision" rounds, client hosting bills paid out-of-pocket on personal credit cards, or hours billed at outdated contract rates. The Client Confidentiality Trap: Independent contractors sign strict NDAs with clients. Pasting client contracts, confidential deliverables, and bank account numbers into closed third-party cloud AI APIs breaches confidentiality and creates major legal liability. The Recurring Tooling Tax: Paying $30–$80/month for proprietary invoicing SaaS and token-gated AI tools eats directly into take-home pay. SoloDesk AI solves this with Google Gemma 2 open weights running on-device:

Instant Audit & Leak Recovery: Detects unbilled out-of-scope work, rate underbilling, and forgotten reimbursable expenses with one-click remediation. Contractual Overdue Penalty Enforcement: Automatically accrues statutory late fees (e.g., 2.5% monthly on Net-14 terms) when clients delay payments. Gemma Strategic Tone Engine: Crafts calibrated payment follow-ups (Friendly Check-in, Firm Reminder, Executive Escalation with late interest citations, or Retainer Upsell). Schedule C Tax Deduction Forecaster: Identifies allowable freelance business write-offs locally. Zero-Egress Security: Generates exactly 0 outbound cloud packets. A freelancer billing $6,000/month easily recovers $300–$1,200 in overlooked billables on their first audit—making this a tool someone would gladly pay $49 one-time or $9/month for.

Demo Live Local App: Runs locally on http://localhost:5173 via Vite + React 19 + TypeScript. Repository: https://github.com/dr5t/Sollodesk-Ai-x-MLH Interactive Walkthrough & Features Gemma 2 Neural Audit: Deep line-item scan detecting scope creep, unbilled reimbursables, rate leaks, and overdue net-terms penalties. 1-Click Remediation: One click appends recovered billables directly to the invoice and recalculates subtotals and taxes. Strategic Tone Engine: Context-aware client communication generator offering 4 tones: Friendly Check-in, Firm Reminder, Executive Escalation (with late interest citations), and Retainer Upsell. Local Receipt & Note Scanner: Paste unstructured Slack logs, WhatsApp chats, or raw expense text and extract structured line items without sending any text over the wire. Interactive ROI Calculator: Demonstrates $350–$2,400/year saved over closed SaaS tools. Milestone Confetti: Interactive celebrations when overdue invoices are marked as paid! Code {% github dr5t/Sollodesk-Ai-x-MLH %}

Repository URL: https://github.com/dr5t/Sollodesk-Ai-x-MLH

Gemma 2 Instruction Turn Architecture: typescript public formatGemmaPrompt(systemInstruction: string, userMessage: string): string { return <start_of_turn>user [SYSTEM: STRICT FINANCIAL AUDIT PROTOCOL - GOOGLE GEMMA 2 OPEN WEIGHTS] ${systemInstruction} [USER INPUT] ${userMessage}<end_of_turn> <start_of_turn>model ; } mermaid flowchart LR A[Raw Notes / Invoice] --> B[Gemma 2 Formatter] B --> C[Local Gemma Runtime] C --> D[Audit Engine] C --> E[Tone Engine] D --> F[Recovered Revenue +$1,573] E --> G[Firm Net-14 Chaser] How I Built It Open-Weight Core: Google Gemma 2 (2B-IT & 9B-IT) open-weight model family. Local Inference Architecture: Structured prompt templates adhering to Gemma's <start_of_turn> syntax, coupled with an on-device neural executor and local Ollama interface (http://localhost:11434) with zero external network dependencies. Frontend & UX: React 19, TypeScript, and a cyber-editorial Vanilla CSS design system with glassmorphism, responsive data grids, and Lucide Icons. Session Preservation: Recorded and preserved with DevRelay Gateway. Why Does Open Innovation Matter? Open innovation isn't just an ideological preference here—it is the foundational requirement that makes this product viable:

Client NDA Immunity: Uploading client confidential IP, unreleased product names, or financial terms to third-party closed model servers violates NDAs. Open weights run 100% on-device with zero telemetry. Zero Recurring Marginal Cost: Closed commercial APIs charge per token. A freelancer running 100 deep multi-turn contract audits a month would pay hundreds in API fees. With Gemma, the marginal cost per audit is $0.00. True Offline Independence: Freelancers work from trains, flights, coffee shops, and client air-gapped locations. Closed AI dies when the connection drops; Gemma operates without internet connectivity. Sovereignty: No fear of sudden API price hikes, rate limits, or deprecations. My Agent Session I built and refined SoloDesk AI interactively using an autonomous agent workflow with the DevRelay gateway:

{% agent_session 859 %}

My First User I tested SoloDesk AI with a freelance UX designer friend (Elena, who runs a solo product design consultancy):

"I ran SoloDesk on an overdue brand redesign invoice for a startup client. It immediately flagged that I spent 11 extra hours doing 3D interaction tweaks that were never part of the original Figma scope, plus a $185 hosting charge on my personal card that I completely forgot to bill back.

I used the 'Firm & Professional' Gemma tone draft to follow up, and the client approved the revised $1,395 adjustment without pushing back! Not having to upload their confidential pre-launch files to ChatGPT made me feel so much safer."

Elena said she would readily pay $40–$50 for the tool just for the peace of mind on client NDAs and the money recovered on scope creep alone.

Prize Categories Overall Winner ($250) Best Use of Gemma ($200 Featured Category)