Fahad565/shamba_negotiator_ai

# Shamba Negotiator AI 🌾🚀 **Protecting Farmer Livelihoods through Predictive Pricing & Market Intelligence** Developed for the **Build with AI Pwani 2026** Hackathon. ## 🧑‍🌾 The Problem Smallholder farmers in Kenya often lose significant income due to: - **Information Asymmetry**: Selling right after harvest when prices crash. - **Climate Shocks**: Unpredictable weather disrupting transport or damaging yields. - **Weak Bargaining Power**: Lack of data-driven negotiation tips in local contexts. ## 🧠 The Solution: Shamba Negotiator Shamba Negotiator is a mobile-first AI agent that acts as a true Market Negotiator. It speaks naturally in **Sheng + English code-switching**, making it accessible and trustworthy for local farmers. ### Key Features - **Predictive Pricing**: Uses historical trends and speculative forecasting to advise on the best time to sell. - **Climate Data Integration**: Factoring in weather forecasts to predict supply shocks (e.g., heavy rains causing transport delays). - **Negotiation Script Generator**: Provides farmers with bargaining tips tailored to the current market. - **Multilingual Support**: Supports natural Sheng + English interaction for a localized experience. ## 🛠️ Architecture & Technology Stack - **Frontend**: Next.js 15 (App Router), Tailwind CSS 4, Shadcn/ui. - **AI Core**: Google Gemini (**deep-research-preview-04-2026**) for complex market reasoning. - **Backend/Database**: Firebase (Authentication & Firestore). - **Deployment**: Google Cloud Run with automated GitHub Actions CI/CD. ## 🌦️ API Integration - **Weather Data**: Integrated logic to pull from local climate forecasts to adjust price predictions. - **Location Services**: Uses browser Geolocation to localize market data and weather alerts to the farmer's specific region. ## 🚀 Getting Started ### Prerequisites - Node.js 20+ - A Google AI Studio API Key (Gemini) - Firebase Project setup ### Installation 1. Clone the repository: ```bash git clone github.com …