This is a submission for the Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle I built DukaanVoice AI, a local-first shop management and point-of-sale application designed for Indian kirana stores and small retailers.
Many small shopkeepers still manage sales, inventory, customer credit (Udhaar), and daily expenses using notebooks or disconnected tools. DukaanVoice AI brings these everyday workflows into one application.
The goal is simple: help small retailers manage their daily business with a practical, locally operated application.
The project includes a five-minute evaluator walkthrough covering the complete retail workflow.
Project repository: https://github.com/gunmasterg9/DukaanVoice-AI Demo guide: https://github.com/gunmasterg9/DukaanVoice-AI/blob/main/docs/SUBMISSION_DEMO_GUIDE.md
The walkthrough demonstrates product entry, a point-of-sale transaction, customer credit and repayment, expense recording, daily cash closing, and inventory reconciliation.
The application currently runs locally on Windows. A publicly hosted interactive demo is not available in this release.
The complete source code is available on GitHub:
Repository: https://github.com/gunmasterg9/DukaanVoice-AI Release: v1.0.1
Release notes: https://github.com/gunmasterg9/DukaanVoice-AI/releases/tag/v1.0.1 The project is built with React, Vite, Python, FastAPI, and SQLite.
The repository includes the source code, testing instructions, regression tests, isolated end-to-end test runners, and the evaluator demo guide.
I built DukaanVoice AI using a local-first architecture:
One of the most important engineering decisions was to make retail transactions auditable and predictable.
Money is stored in integer paise, inventory quantities use integer milli-units, stock movements are recorded for auditing, and sales require explicit confirmation. Customer payments and cash-drawer calculations are kept distinct so that digital payments are not incorrectly counted as physical cash.
I also added regression coverage for duplicate product lines, customer-credit reversals, cash refunds, daily closing records, and database persistence.
Current scope: Version 1.0.1 focuses on reliable local-first retail workflows and multilingual usability. It does not yet integrate an open-weight language model for inference. Adding a locally runnable assistant for natural-language sales and inventory commands is a potential future extension, not a feature claimed by this release.
Small businesses need affordable software that they can understand, adapt, and operate without depending entirely on expensive cloud services.
Open-source development makes it possible for developers and local communities to inspect the code, report bugs, contribute improvements, and adapt workflows for their own needs.
For a project like DukaanVoice AI, this matters because retail practices differ across regions and languages. A transparent, extensible application can evolve around the needs of real shopkeepers. The current release demonstrates the local-first application and its auditable workflows. Integrating open-weight AI in a future version could extend this approach to natural-language product entry, sales drafting, and multilingual assistance while keeping transaction confirmation and financial calculations under deterministic application control.
DukaanVoice AI was developed through an iterative workflow of implementation, code review, regression testing, and release verification.
The project repository includes the implementation and testing artifacts:
https://github.com/gunmasterg9/DukaanVoice-AI I have not included a DevRelay session recording in this post.
The current release has been rehearsed using synthetic retail data to demonstrate product entry, sales, customer credit, repayments, expenses, cash closing, and inventory reconciliation.
Real-world shopkeeper feedback and paid usage have not yet been documented. My next goal is to put DukaanVoice AI in front of a local retailer, observe their daily workflow, and use their feedback to guide future improvements.
I'm submitting DukaanVoice AI for the overall Hacktoberfest Open-Source AI Challenge: Week 2 prize.
DukaanVoice AI focuses on practical, local-first retail workflows for Indian kirana stores, including point-of-sale transactions, customer Udhaar, expense tracking, cash reconciliation, and multilingual usability.
I am not claiming a partner prize category because I have not verified that the released version meaningfully integrates any of the listed partner technologies.
DukaanVoice AI is an individual project submission. No team members to credit.
Thanks for participating!