A comprehensive mobile money credit scoring platform for emerging markets, specifically designed for Ghana's financial ecosystem. This system analyzes mobile money transaction data from MTN Mobile Money, Vodafone Cash, and AirtelTigo Money to generate credit scores for financial inclusion.

momo-credit-score/
├── backend/                    # Python backend services
│   ├── src/
│   │   ├── api/               # FastAPI endpoints
│   │   ├── models/            # ML models & training
│   │   ├── features/          # Feature engineering
│   │   ├── data/              # Data processing & ETL
│   │   ├── utils/             # Utility functions
│   │   ├── credit_score.py    # Core scoring logic
│   │   └── index.ts           # Node.js API bridge
│   ├── tests/                 # Backend tests
│   └── pyproject.toml         # Python dependencies
├── frontend/                   # React TypeScript frontend
│   ├── src/
│   │   ├── components/        # React components
│   │   ├── pages/             # Page components
│   │   ├── utils/             # Frontend utilities
│   │   └── assets/            # Static assets
│   └── tests/                 # Frontend tests
├── docs/                      # Documentation
│   ├── literature/            # Research & literature
│   ├── planning/              # Project planning docs
│   ├── samples/               # Sample data files
│   └── API.md                 # API documentation
├── .devcontainer/             # Development container config
└── README.md                  # This file

The MoMo Credit Score Generator provides intelligent credit scoring capabilities using mobile money transaction data. Built with modern development practices and designed specifically for the financial inclusion challenges in emerging markets like Ghana.

• Multi-language support: TypeScript/JavaScript and Python implementations
• Modern React Frontend: Professional dashboard with Material-UI components
• Real-time Analytics: Comprehensive scoring analytics and model monitoring
• Modern toolchain: Latest versions of Node.js, Python, and development tools
• Development containers: Ready-to-use dev containers for consistent environments
• Code quality: Pre-commit hooks, linting, and formatting
• Testing: Comprehensive test suites for all components

# Clone the repository
git clone https://github.com/tmarhguy/momo-credit-score.git
cd momo-credit-score

# Install dependencies
npm install
cd frontend && npm install && cd ..
poetry install

# Start development servers
npm run dev:all  # Runs both backend and frontend
# OR run individually:
npm run frontend:dev    # Frontend only (http://localhost:5173)
npm run dev            # Backend TypeScript watch mode

The frontend provides a comprehensive dashboard with:

• Dashboard: Real-time metrics, charts, and KPIs
• Credit Scoring: Interactive credit score generation interface
• Analytics: Detailed performance analytics and trends
• Model Monitoring: Real-time model drift and performance monitoring
• Settings: System configuration and preferences

Access the dashboard at: http://localhost:5173

• Frontend: React 18, TypeScript, Vite, Material-UI, Recharts
• Backend: Node.js 22.17.0 (LTS), Python 3.13.5
• Package Management: npm (Frontend), Poetry (Python)
• Code Quality: ESLint, Prettier, Ruff, Black
• Development: VS Code with dev containers

See API Documentation for detailed development instructions.

Built by Tyrone Marhguy