kaksv/sokoto-ai

Bridging the gap between Ugandan farmers and the markets for their produce. # SokoAgent AI 🤖🌾 **AI-Powered Market Access for Ugandan Smallholder Farmers** SokoAgent AI eliminates middleman exploitation by connecting smallholder farmers directly to fair markets through a simple USSD interface — no smartphone required. Just dial `*347*1#`, get AI-powered price insights, and sell at fair value. Built during the **QwenCloud Global AI Hackathon 2026**. --- ## 🚀 Features - **USSD Interface** — Works on any phone, no internet needed. Dial `*347*1#` to start. - **AI-Powered Pricing** — QwenCloud AI analyzes market data to provide fair, real-time crop prices. - **Buyer Matching** — Automatically connects farmers with verified buyers offering competitive rates. - **Multilingual Support** — English, Luganda, and Runyankore. - **Mobile Money Integration** — Receive payments directly to your mobile money account. - **Price Alerts** — Get notified when crop prices hit your target. --- ## 🏗️ Architecture ``` ┌─────────────────────────────────────────────┐ │ User Layer (Any Phone) │ │ USSD *347*1# │ SMS Gateway │ └─────────────────┬───────────────────────────┘ │ ┌─────────────────▼───────────────────────────┐ │ Communication Layer (Africa's Talking) │ │ USSD Session Manager │ SMS │ Mobile Money │ └─────────────────┬───────────────────────────┘ │ ┌─────────────────▼───────────────────────────┐ │ Application Layer (Node.js + Express) │ │ REST API │ Session State Machine │ Cache │ └─────────────────┬───────────────────────────┘ │ ┌─────────────────▼───────────────────────────┐ │ AI & Data Layer (QwenCloud) │ │ NLU │ Price Prediction │ Buyer Matching │ └─────────────────────────────────────────────┘ ``` ### Request Flow 1. **Farmer dials** `*347*1#` on any phone 2. **Africa's Talking** routes the USSD request to our backend 3. **Express server** processes the session and determines intent 4. **QwenCloud AI** analyzes the request, calls tools (market prices, buyer looku …