tympersie22/KodiSmart

Invisible tax compliance for East Africa. Your M-Pesa is your accounting system. Your WhatsApp is your invoice book. Your phone is your EFD. # KodiSmart **Invisible tax compliance for East Africa.** Your M-Pesa is your accounting system. Your WhatsApp is your invoice book. Your phone is your EFD. *Kodi bila wasiwasi — Tax without worry.* --- ## What is KodiSmart? KodiSmart automates tax compliance for 14 million+ small businesses across East Africa. No new hardware. No training. Just use M-Pesa, WhatsApp, or USSD as you normally do — KodiSmart handles the tax receipts, filings, and compliance automatically. ## Architecture ``` ┌─────────────────────────────────────────────────────┐ │ CAPTURE LAYER │ │ M-Pesa (KE+TZ) │ USSD (2G phones) │ WhatsApp │ └────────┬──────────┴─────────┬──────────┴──────┬─────┘ │ │ │ ┌────────▼────────────────────▼─────────────────▼─────┐ │ COMPLIANCE BRIDGE │ │ TRA VFD (TZ) │ KRA eTIMS (KE) │ URA EFRIS (UG)│ │ ZRA VFMS (Zanzibar) │ RRA EBM (RW) │ └────────┬────────────────────┬─────────────────┬─────┘ │ │ │ ┌────────▼────────────────────▼─────────────────▼─────┐ │ INTELLIGENCE LAYER │ │ AI Categorizer │ VAT Predictor │ Anomaly Detect │ │ Swahili NLP │ Daily Savings │ └─────────────────────────────────────────────────────┘ ``` ## Multi-Jurisdiction VAT | Jurisdiction | Rate | Authority | Protocol | |-------------|------|-----------|----------| | Tanzania Mainland | 18% | TRA | VFD (XML) | | Zanzibar | 15% | ZRA | VFMS | | Kenya | 16% | KRA | eTIMS (JSON) | | Uganda | 18% | URA | EFRIS (JSON) | | Rwanda | 18% | RRA | EBM | ## Quick Start ### Local Development ```bash # Clone git clone github.com cd KodiSmart # Setup python3.12 -m venv .venv source .venv/bin/activate pip install -e ".[dev]" # Database createdb kodismart cp .env.example .env alembic upgrade head # Run uvicorn kodismart.app:app --reload …