SK3CHI3/FarmIQ

Farmer Data Intelligence Platform — a unified dashboard and API layer that ingests, quality-checks, and monetizes smallholder farmer data for Africa. # FarmIQ > Farmer Data Intelligence Platform — a unified dashboard and API layer that ingests, quality-checks, and monetizes smallholder farmer data for East Africa. FarmIQ helps agribusinesses, cooperatives, and financial service providers answer one question: **"Which farmers are decision-ready, and what data is missing to get them there?"** It brings together field registries, payment histories, cooperative records, and geo sources into a single view, then scores each farmer across a four-tier data model and six Government-of-Kenya baseline fields. The current MVP targets Kenya and Nigeria with real-world data sources such as KIAMIS, Tegemeo, Agrovesto, KALRO, and Nigeria's National Digital Farmer Registry. --- ## Table of Contents - What this project does - Tech stack - Core data model - Application pages - Architecture - Database: Neo4j - Why a graph database - Neo4j schema migration (Cypher) - SQL table → Neo4j mapping - Common Cypher queries - Getting started - Environment variables - Deployment notes - Contributing --- ## What this project does Smallholder agriculture is fragmented. A single farmer may exist in a government registry, a cooperative spreadsheet, a mobile-money wallet, and a satellite field map — but none of those systems talk to each other. FarmIQ fixes that by: 1. **Ingesting** multiple data sources through CSV upload, API connectors, webhooks, and graph sync. 2. **Linking** records to a single farmer identity using a graph database (Neo4j). 3. **Scoring** completeness against a 4-tier model and 6 GoK baseline fields. 4. **Flagging** quality issues (missing phones, missing GPS, duplicates, consent gaps). 5. **Enabling decisions** — credit, insurance, and input financing readiness — so partners can act on the data. ### MVP scope - 7 primary data sources: KIAMIS Registry, Tegemeo Cooperative Register, Agrovesto Field Agents, M-Pesa Payment History, KALRO Satellite/Weather, Nigeria NDFR, AgStack Field Registry. - 2 countries: Kenya, …