susan-awori/hustle-bookkeeping

# Buku > **Voice-First AI Bookkeeping Mobile App for Informal Traders in Kenya** 🇰🇪 Buku empowers local merchants (mama mboga, boda riders, kiosk owners) to record their daily sales, expenses, and customer debts simply by **speaking into their phone**. It transcribes spoken mixed Kiswahili, Sheng, or English using **ElevenLabs Scribe (`scribe_v1`)**, extracts structured financial transactions using **Claude Sonnet**, speaks a voice confirmation back to the merchant, and persists ledger records in a zero-config database. --- ## 🏗️ Repository Architecture ```text hustle-bookkeeping/ ├── backend/ # FastAPI Python Backend (SQLAlchemy, Uvicorn, Alembic, SQLite/Postgres) │ ├── app/ │ │ ├── routers/ # Voice, Ledger, Auth endpoints │ │ ├── services/ # ElevenLabs (STT/TTS) & Claude (LLM Ledger Parser) │ │ └── models.py # SQLAlchemy Ledger & Trader models (SQLite & Postgres compatible) │ └── tests/ # Pytest unit & integration test suite (100% passing) ├── buku/ # Buku Flutter Mobile App (Android & iOS) │ └── lib/ │ ├── main.dart # App entrypoint (Zero-barrier instant access) │ ├── src/ │ │ ├── models/ # Dart data models (LedgerEntry, Trader, VoiceParseResponse) │ │ ├── screens/# Voice Deck, Sales Ledger, Debt Collectors, Reports │ │ ├── services/# REST API Client & English/Swahili Localization Service │ │ └── theme/ # Clean, high-contrast theme with large readable typography ├── render.yaml # Render Cloud Deployment Blueprint └── README.md ``` --- ## 🌟 Key Features 1. **🎙️ Voice-First Merchant Deck**: - Tap the central microphone button to record live audio from your phone. - Powered by **ElevenLabs Scribe (`scribe_v1`)** with native Swahili & English speech recognition. - **Audio Talk-Back**: Speaks a spoken confirmation audio out loud back to the trader via **ElevenLabs Multilingual TTS (`eleven_multilingual_v2`)**. 2. **🧠 AI Ledger Extraction (Claude)* …