eidamindada/coffeaai

African Coffee Market Intelligence Platform — Free for farmers. Always. # ☕ CoffeaAI — Global Coffee Market Intelligence > Free AI-powered coffee market platform for African farmers, traders, exporters, and cooperatives worldwide. --- ## 🌍 Why CoffeaAI? Africa produces over **12% of the world's coffee** — Ethiopia, Uganda, Kenya, Rwanda, Tanzania — yet African smallholder farmers have no unified platform for: - Daily market prices in their native language - Real-time disease and weather alerts - Direct connections with global buyers - AI-powered market advice **CoffeaAI closes that gap. Free for farmers. Always.** --- ## 🚀 Features | Feature | Description | |---|---| | 📈 **Live Prices** | Arabica, Robusta & specialty origins — USD/lb | | 📊 **Price Charts** | 1M / 3M / 6M / 1Y trend visualization | | 🌦️ **Crop Alerts** | Weather, disease & pest warnings by region | | 📰 **Market News** | Reuters, FAO, UCDA, ICO & more | | 🌐 **7 Languages** | English, Swahili, Amharic, Hausa, Yoruba, French, Portuguese | | 🔍 **Sector Filter** | Farming · Trading · Export · Specialty | | 🤖 **AI Advisor** | Claude-powered assistant — responds in your language | --- ## 🏗️ Tech Stack ### Frontend - **React 18 + Vite** — Fast, modern UI - **TailwindCSS** — Responsive dark-mode design - **Recharts** — Price trend charts - **Anthropic Claude API** — AI Market Advisor ### Backend - **FastAPI** — Python REST API - **PostgreSQL** — Production database - **Docker Compose** — Local dev stack --- ## 🛠️ Quick Start ### 1. Clone ```bash git clone github.com cd coffeaai ``` ### 2. Frontend ```bash cd frontend npm install cp .env.example .env # Add your VITE_ANTHROPIC_API_KEY to .env npm run dev # → localhost ``` ### 3. Backend (optional for MVP) ```bash cd backend python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate pip install -r requirements.txt uvicorn app.main:app --reload # → localhost ``` ### 4. Full stack with Docker ```bash docker-compose up --build ``` …