ahmednule/kilimoai

Kenya AI Challenge Hackathon Project # Kilimo AI **Hackathon project** — built for the Kenya AI Challenge 2026 / Mercy Corps AgriFin. A decentralized farming fintech platform connecting Kenyan smallholder farmers with lenders, agents, buyers, and chama groups — powered by **Neo4j** for the knowledge graph and **M-Pesa** for payments and loan disbursements. --- ## Table of Contents - Tech Stack - Architecture Overview - User Roles - Getting Started - Environment Variables - Database - Scripts - Seed Data - Neo4j Verification Commands - Project Structure --- ## Tech Stack | Layer | Technology | |---|---| | **Framework** | Next.js 16 (App Router) | | **Language** | TypeScript | | **Styling** | Tailwind CSS + `cn` utility | | **Database** | Neo4j (AuraDB / graph database) | | **Payments** | M-Pesa (Daraja API) | | **USSD** | Africa's Talking API | | **AI Agents** | LangChain agents for farm assessment & pest detection | | **PWA** | Service worker with offline support | | **Package Manager** | pnpm | --- ## Architecture Overview ``` ┌─────────────┐ ┌──────────────┐ ┌──────────────┐ │ Farmer │ │ Agent │ │ Buyer │ │ (Mobile) │ │ (Mobile) │ │ (Mobile) │ └──────┬──────┘ └──────┬───────┘ └──────┬───────┘ │ │ │ └───────────────────┼─────────────────────┘ │ ┌──────▼──────┐ │ Next.js 16 │ │ App Router │ └──────┬──────┘ │ ┌────────────┼────────────┐ │ │ │ ┌──────▼─────┐ ┌───▼────┐ ┌────▼─────┐ │ Neo4j │ │M-Pesa │ │ Africa's │ │ AuraDB │ │Daraja │ │ Talking │ └────────────┘ └────────┘ └──────────┘ ``` --- ## User Roles | Role | Description | Key Pages | |---|---|---| | **Farmer** | Registers farm profile, applies for loans, views risk assessments, lists produce, joins chamas | `/chat`, `/loans`, `/marketplace/my-listings`, `/chama`, `/dashboard` | | **Agent** | Verifies farmers in the field, schedules visits, verifies produce quality | `/agent/verify`, `/agent/schedule` …