FestFiti/cashflow-ai

AI-powered cash flow management for African SMEs — M-Pesa payments, Claude AI invoicing, real-time WebSocket dashboard # CashFlow AI — Intelligent Business Payment Orchestration An AI-powered cash flow management platform that helps SMEs automate their entire cash flow cycle — from invoice generation to payment collection to reconciliation — using Claude AI and M-Pesa. ## Problem Statement African Small and Medium Enterprises (SMEs) face a critical cash flow management crisis: - **60%** struggle with late payments extending to 45-60 days - **70%** still use manual invoicing processes consuming 15-20 hours weekly - **40%** cannot scale due to cash flow constraints - **8-12%** annual revenue lost due to payment delays - Fragmented financial systems with no real-time visibility **Core Value Proposition:** "An intelligent tool built to request payments, collect via M-Pesa, and track every shilling in real time. Built for African Business." ## Screenshots ### Dashboard - Real-time Cash Flow Overview ### AI Invoice Generation ### Payment Request & Collection ### Smart Reminders Automation ## Live Demo **Live:** flowai.cash ### Test Account - Email: `tomsteve187@gmail.com` - Password: `gKe7Kbaf2WJyRRC` ## Architecture ``` ┌─────────────────┐ ┌──────────────────┐ ┌──────────────────────┐ │ SvelteKit UI │────▶│ FastAPI API │────▶│ External Services │ │ (port 9999) │◀────│ (port 8888) │◀────│ M-Pesa / Ratiba / │ │ │ │ │ │ Claude AI │ └─────────────────┘ └──────────────────┘ └──────────────────────┘ │ ┌─────┴──────┐ │ PostgreSQL │ │ + Redis │ └────────────┘ ``` ## Quick Start (Docker) ```bash # Clone the repo git clone github.com cd cashflow-ai # Copy environment files cp backend/.env.example backend/.env # Start everything docker compose up --build ``` - Frontend: localhost - Backend API: localhost - API Docs: localhost ## Quick Start (Local Development) **Backend** ```bash cd backend python3 -m …