This is a submission for the Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle
What I Built
🌟 Core Vision & Philosophy
- "Your AI. Your Business. Your Rules."
- The platform automates high-frequency business operations while ensuring that private financial records, customer data, and sales numbers never leak to external cloud servers or get impacted by LLM hallucinations.
🛠️ The 5 Core Business Tools
- Smart Listing Writer: Generates multi-marketplace titles, bullet points, and keyword SEO (for Amazon, Etsy, Shopify, eBay, and Local platforms) using local open-weight models via Ollama.
- Invoice Studio & PDF: Features a real-time line-item calculator handling discounts and taxes using strict deterministic math (zero LLM errors) paired with instant branded PDF exports via ReportLab.
- Receipt Organizer: A drag-and-drop OCR tool that parses vendor names, transaction dates, and totals using regex heuristics while flagging low-confidence fields for manual review.
- Marketing Copywriter: Creates viral Instagram captions, WhatsApp promotional broadcasts, and festival campaigns in both English and Hindi with tone and length controls.
- Business Email Writer: Drafts formal quotations, client follow-ups, payment reminders, and customer support resolutions with one-click clipboard copying.
📐 System Architecture & Tech Stack
-
Frontend (
/frontend): Built with React 19, TypeScript, and Tailwind CSS, featuring an interactive landing page preview, theme toggle, and a live AI status indicator. -
Backend (
/backend): Built with FastAPI and Python 3.11+, acting as a secure API gateway with JWT authentication and a strict privacy dispatcher. - Storage: Powered by a local SQLite (or optional PostgreSQL) database for saved projects, invoices, and history, alongside a local folder keeping receipt uploads 100% on-device.
- Dedicated Processing Engines:
-
AI Generation Engine: Defaults to local
llama3.2:3bvia Ollama with an air-gapped rule engine fallback. - Math & PDF Engine: Completely programmatic Python calculations for flawless invoicing.
- OCR Engine: Clean and text-extraction parser for receipts.
🛡️ Key Technical Highlights
- Privacy Modes: Supports a default Local Mode (air-gapped, zero telemetry) and an opt-in Remote Mode for custom OpenAI-compatible endpoints (like vLLM or OpenRouter).
-
Automated Testing Suite (
/backend/tests): Includes comprehensive test coverage (pytest) validating exact mathematical precision in invoices, PDF byte stream generation, OCR heuristic parsing, and bilingual template generation. -
Developer Experience: Includes Docker Compose configuration (
docker-compose.yml), environment templates (.env.example), and quickstart launchers for Windows (run_dev.bat) and Unix (run_dev.sh).
Demo
https://github.com/adityanathpatel/HustleAI
Code
https://github.com/adityanathpatel/HustleAI
How I Built It
- Frontend: Developed using React 19, TypeScript, and Tailwind CSS to create a responsive, theme-toggleable user interface.
Backend: Built with FastAPI and Python, serving as an API gateway with JWT authentication and a local privacy dispatcher.
Specialized Engines:
Separated creative tasks into local open-weight AI models via Ollama (Llama 3.2).
Used strict Python math and ReportLab for zero-error invoice calculations and PDF exports.
Implemented regex heuristics for receipt OCR text parsing.
Storage & Security: Utilized an on-device SQLite database and local folder storage to ensure 100% data sovereignty and an air-gapped workflow.
Why Does Open Innovation Matter?
Open innovation matters because no single company has all the best ideas or resources in-house. By collaborating with external developers, users, and partners, organizations can:
- Speed up development instead of building everything from scratch.
- Access specialized expertise and fresh perspectives beyond internal teams.
- Lower R&D costs and share risks across a broader network.
- Build customer-centric products through direct co-creation and real-world feedback.
Prize Categories
For HustleAI,
- Open Source / Open Innovation (Utilizes local open-weight models via Ollama and an MIT-licensed architecture)
- AI & Machine Learning / Productivity (A local business copilot with automated listing generation, OCR, and invoice tools)
- Privacy & Security / Data Sovereignty (Air-gapped architecture with zero cloud telemetry and 100% on-device storage)
Top comments (1)
Do check it out