Wekkitech/SomoLink

Open-source, AI-powered connectivity and learning platform that provides solar-driven internet access, cached educational content, and real-time analytics for schools and surrounding communities across Africa. # SomoLink 🌍⚡📡 **AI-Powered, Solar-Driven Digital Learning Infrastructure** Developed by Wekkitech Limited, Kenya ## 🎯 Mission SomoLink provides reliable, intelligent, and community-sustained internet access to schools and nearby communities in underserved regions across Kenya and East Africa. ## 🏗️ Architecture Overview SomoLink operates on four main layers: 1. **Edge Layer** - Solar-powered devices providing Wi-Fi, content caching, and telemetry 2. **AI & Data Layer** - ML models for solar forecasting, QoS optimization, and analytics 3. **Backend Services** - APIs for billing, data ingestion, and federated learning 4. **Frontend Layer** - Dashboards for schools, communities, and operators ## 📦 Monorepo Structure ``` somolink/ ├── services/ # Backend microservices │ ├── edge-agent/ # Go-based edge device software │ ├── ai-platform/ # Python ML services │ ├── api-gateway/ # NestJS API gateway │ ├── billing/ # Billing and payments service │ └── data-ingestion/ # Telemetry and analytics ingestion ├── apps/ # Frontend applications │ ├── school-dashboard/ # Next.js school interface │ ├── admin-dashboard/ # Admin and operator dashboard │ └── community-portal/ # Public community access portal ├── infrastructure/ # IaC and deployment configs │ ├── terraform/ # Cloud infrastructure │ ├── kubernetes/ # K8s manifests │ └── helm/ # Helm charts ├── libs/ # Shared libraries │ ├── shared-types/ # TypeScript type definitions │ ├── api-clients/ # Auto-generated API clients │ └── utils/ # Common utilities ├── docs/ # Documentation └── scripts/ # Build and deployment scripts ``` ## 🚀 Quick Start ### Prerequisites - **Docker** 20.10+ - **Node.js** 18+ and **pnpm** 8+ - **Python** 3.11+ - **Go** 1.21+ - **Kubernetes** cluster (local: minikube/kind, cloud: GKE/EKS/AKS) - **T …