eagleisbatman/gap-chat-widget

FarmerChat widget with OpenAI ChatKit integration for Kenya agriculture intelligence # 🌾 FarmerChat Widget **OpenAI ChatKit-powered chat widget for agricultural intelligence.** Complete chat interface with session server that connects farmers to real-time weather forecasts, planting recommendations, and irrigation advice through conversational AI. ## ✨ Features - 💬 Floating chat widget with clean agricultural theme - 🌤️ Real-time weather forecasts via OpenAI Agent Builder + MCP - 🎤 **Voice input/output** - Speak your questions, hear responses (English & Swahili) - 🌍 **Bilingual support** - Full English and Swahili language support - 📸 **Plant disease diagnosis** - Upload photos for AI-powered health analysis - 📍 **Location-aware** - Auto-detect location or use default coordinates - 🌱 User-friendly responses (no technical jargon) - 📱 Fully responsive (desktop, tablet, mobile) - ⚡ Session server with configurable default coordinates - 🔄 Auto-session management with ChatKit ## 🏗️ Architecture ``` Frontend (index.html + chatkit.js) ↓ Session Server (server.js) - Creates ChatKit sessions - Injects default farm coordinates via headers ↓ OpenAI ChatKit API ↓ OpenAI Agent Builder Workflow - Configured with SYSTEM_PROMPT.md ↓ MCP Server (gap-agriculture-mcp) - Receives coordinates from headers - Provides 4 agricultural tools ``` ## 🌍 Geographic Coverage **IMPORTANT:** This chat widget depends on the gap-agriculture-mcp server, which uses TomorrowNow's Global Access Platform (GAP) for weather data. **GAP coverage is limited to specific regions.** Before deploying, verify that GAP supports your target region at tomorrownow.org. Current GAP coverage includes parts of East Africa (Kenya, Tanzania, Uganda, Ethiopia, Somalia) and potentially other regions. ## 🏃 Quick Start ### Prerequisites - Node.js >= 18.0.0 - OpenAI API key - Agent Builder workflow ID - MCP server deployed (see gap-agriculture-mcp) - **Verify GAP covers your target region** ### Local Development ```bash # Clone and install git clone github.com …