CollinsAnyona/shamba-salama

AI-powered agricultural extension platform for smallholder farmers in Kenya - Flask, OpenAI chatbot, marketplace, expert booking. # Shamba Salama **AI-Powered Agricultural Extension for Smallholder Farmers** Shamba Salama is transforming agriculture in Kenya by delivering real-time, localized, and AI-driven farming support and market insights to smallholder farmers—directly through mobile phones. Designed to bridge the gap left by limited extension services, our platform empowers farmers with tools that boost productivity, increase income, and build resilience. --- ## Table of Contents 1. Overview 2. Key Features 3. Technologies Used 4. Setup and Installation 5. Usage 6. Contributing --- ## Overview Shamba Salama supports underserved farmers with AI-powered chatbots and real-time market access tools. Our platform is built to operate on smartphones, feature phones (via USSD/SMS), and desktop interfaces—making it inclusive, responsive, and scalable. So far, we’ve reached 200+ farmers in our pilot phase, with many reporting up to a 25% yield increase and a 30% improvement in household income. --- ## Key Features ### 🤖 **AI Chatbot Extension** * Real-time, multilingual (English & Kiswahili) support for crop issues, planting guides, and pest management. ### 📈 **Market Intelligence** * Live price trends, selling recommendations, and buyer connections to eliminate middlemen. ### 📚 **Localized Learning** * Personalized advice based on region, season, and crops. ### 📱 **Mobile-First Access** * Works via SMS/USSD for farmers without smartphones. --- ## Technologies Used * **Frontend:** HTML5, Tailwind CSS * **Backend:** Python (Flask), Jinja2 * **AI:** OpenAI/GPT (with plans for LLaMA 3 integration) * **Database:** SQLite * **Deployment:** render, GitHub --- ## Setup and Installation 1. **Clone the repository:** ```bash git clone github.com cd shamba-salama ``` 2. **Create and activate a virtual environment:** ```bash python -m venv env env\Scripts\activate # Windows ``` 3. **Install dependencies:** ```bash pip install -r requirements …