Moraa021/digicow-ai-farmer-intelligence

AI-Powered Farmer Intelligence System for Youth Extension Agents - Kenya AI Challenge 2026 # 🐄 DigiCow AI - Farmer Intelligence System > AI-powered decision support for youth extension agents in Kenya. --- ## 📌 Overview **DigiCow AI** helps youth extension agents deliver personalized, data-driven advisory services to smallholder farmers. This repository contains the **backend API** built with Flask, Neo4j, and Featherless AI. The frontend is hosted on Lovable and connects to this API. **Key Features:** - 📊 Farmer management with priority scoring - 🗄️ Neo4j knowledge graph (farmers, cows, diseases, soil) - 🤖 AI-generated recommendations (Featherless AI) - 📋 Export data as CSV/PDF --- ## 🚀 Quick Start ### 1. Clone & Setup ```bash git clone github.com cd digicow-ai-farmer-intelligence python -m venv venv venv\Scripts\activate # Windows source venv/bin/activate # Mac/Linux pip install -r requirements.txt ``` ### 2. Configure `.env` ```env NEO4J_URI=bolt://localhost:7687 NEO4J_USER=neo4j NEO4J_PASSWORD=your-password FEATHERLESS_API_KEY=your-api-key ``` ### 3. Initialize Database ```bash python init_db.py ``` ### 4. Start API ```bash python api.py ``` API runs at: `localhost` --- ## 🔗 API Endpoints | Endpoint | Method | Description | |---|---|---| | `/farmers` | GET | List all farmers | | `/farmers/{name}` | GET | Get farmer details | | `/recommend` | POST | Get AI recommendation | | `/farmers/add` | POST | Add new farmer | | `/farmers/delete/{name}` | DELETE | Delete farmer | --- ## 📊 Data Model ``` (Farm) -[:OWNS]-> (Cow) (Farm) -[:AFFECTED_BY]-> (Disease) (Farm) -[:HAS_SOIL]-> (Soil) (Disease) -[:TREATS]-> (Advisory) ``` --- ## 👥 Team Z01Techies | Name | Role | |---|---| | Mercy Naliaka Moraa | Team Lead | | Micheal Clay Ochieng | Backend | | Grace Nyaboke | Frontend | | Taheera Mohamed | AI Integration | | Millicent Odhiambo | Data | --- ## 🏆 Kenya AI Challenge 2026 **Track:** Mercy Corps AgriFin **Problem:** Extension agents lack tools for personalized farmer sup …