JoshuaMinase/megeb

Community-driven platform for Ethiopian recipes — every dish can have multiple user-submitted variations, plus AI cooking assistance. # 🍽️ Megeb - Ethiopian Recipe Platform *A modern, community-driven recipe platform featuring authentic Ethiopian cuisine powered by AI* ## ✨ Features - **🍴 Extensive Recipe Database** - 79+ authentic Ethiopian dishes with real cookbook photography - **🤖 AI-Powered Search** - Intelligent recipe discovery using RAG (Retrieval-Augmented Generation) with Groq - **👥 Community Contributions** - User-submitted recipes with moderation system - **🌍 Personalized Experience** - Nationality-based recommendations and trending dishes - **📸 Rich Media** - High-quality images hosted on Cloudinary - **🔐 Secure Authentication** - JWT-based auth with role-based access control - **📊 Meal Planning** - Integrated pantry management and nutrition tracking - **🔄 Recipe Variations** - Multiple recipe variations per dish with rating system ## 🏗️ Architecture ### Tech Stack - **Frontend**: Plain HTML/CSS/JavaScript (no build step required) - **Backend**: FastAPI with Motor (async MongoDB driver) - **Database**: MongoDB Atlas (production) or local MongoDB (development) - **Image Storage**: Cloudinary CDN - **AI**: Groq API for intelligent recipe generation and search - **Authentication**: JWT with bcrypt password hashing ### System Design ``` ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ Frontend │ │ Backend │ │ MongoDB │ │ (Static HTML) │◄──►│ (FastAPI) │◄──►│ Atlas │ └─────────────────┘ └─────────────────┘ └─────────────────┘ │ ▼ ┌──────────────┐ │ Cloudinary │ │ Images │ └──────────────┘ ``` ## 🚀 Quick Start ### Prerequisites - Python 3.8+ - MongoDB Atlas account (free tier available) - Cloudinary account (free tier available) - Groq API key (free tier available) ### Installation 1. **Clone the repository** ```bash git clone github.com cd megeb ``` 2. **Set up environment variables** ```bash cp .env.example .env # Edit .env with your actual configuration ``` …