Skip to content

Latest commit

 

History

History
176 lines (122 loc) · 6 KB

README.md

File metadata and controls

176 lines (122 loc) · 6 KB

CuisineRAG Logo

License Python Tavily Search Groq TUF

🍴 CuisineRAG

The Intelligent Moroccan Cuisine Companion

An AI-powered recipe assistant revolutionizing how you discover and adapt Moroccan cuisine.
Built with Retrieval-Augmented Generation (RAG) and powered by Tavily Search API and Llama (Groq/TUF), CuisineRAG offers personalized recipe recommendations while honoring culinary traditions.

⚠️ Under Development:
This is an academic research project in its early stages, with exciting features rolling out in 2024.

Last Updated: December 2024

🌍 What is CuisineRAG?

CuisineRAG is more than a recipe assistant—it’s a blend of Morocco’s rich culinary heritage and cutting-edge AI. Designed to meet the needs of modern food enthusiasts, it provides:

  • Instant access to authentic Moroccan recipes through real-time AI-driven search.
  • Culturally informed adaptations of recipes for various dietary preferences.
  • Seamless, human-like interactions that guide users through a culinary journey.

Why CuisineRAG?

✨ Preserve Tradition: Celebrate the essence of Moroccan cuisine while embracing dietary inclusivity.
✨ Empower Choices: Dynamically adapt recipes with substitutions that fit your lifestyle.
✨ Leverage Innovation: Rely on the latest AI technology to transform how you cook and eat.

🚀 Key Features

🧠 Smart Recipe Retrieval

  • Real-time Search: Powered by the Tavily Search API, CuisineRAG fetches the freshest and most relevant Moroccan recipes online.
  • Curated Database: A robust offline recipe library ensures availability even without internet access.
  • Caching: Frequently accessed recipes are stored locally for lightning-fast retrieval.

🛠️ Intelligent Recipe Adaptation

  • Advanced ingredient substitutions tailored to dietary restrictions like vegan, gluten-free, keto, and more.
  • AI algorithms ensure recipes retain nutritional balance and authentic Moroccan flavors.
  • Built-in cultural safeguards to preserve the soul of traditional Moroccan dishes.

💬 Natural Language Interactions

  • Conversational AI: Ask questions, get recipe clarifications, or explore cooking tips naturally.
  • Multi-turn Dialogues: Smoothly handle complex or multi-step cooking queries.
  • Smart Suggestions: Get ingredient recommendations based on your pantry and preferences.

🥗 Dietary Flexibility

CuisineRAG adapts Moroccan recipes to fit a variety of dietary lifestyles, supporting:

✓ Vegan/Vegetarian
✓ Gluten-free
✓ Keto
✓ Low-fat
✓ Diabetic-friendly
✓ Low-sodium

🧑‍🍳 Example: Transform a traditional chicken pastilla into a keto-friendly delight without compromising on flavor or texture.

🛠 Technical Blueprint

Technology Highlights

Component Tech Stack
Backend Python 3.8+, FastAPI, SQLAlchemy,Llamaindex, Langchain
AI/ML Llama (Groq/TUF), Sentence Transformers
Caching Redis
Database SQL + Qdrant
Search Tavily Search API

Key Algorithms

  • Retrieval-Augmented Generation (RAG): Combines real-time search results with offline data for unmatched flexibility.
  • Semantic Understanding: Uses sentence transformers for deep contextual awareness of user queries.
  • Adaptation Engine: Dynamically adjusts recipes while preserving cultural authenticity.

📊 Performance Metrics

Metric Result
Average Recipe Retrieval Time < 10 seconds
Recipe Adaptation Accuracy 95%
User Satisfaction Score 4.0/5.0
Average Response Time < 12 seconds

💻 Getting Started

System Requirements

  • Python 3.8+
  • Minimum 8GB RAM
  • 20GB storage space
  • (Optional) CUDA-compatible GPU for faster AI processing

Installation

# Clone the repository
git clone https://github.com/yourusername/CuisineRAG.git
cd CuisineRAG

# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate  # For Linux/Mac
.\venv\Scripts\activate   # For Windows

# Install dependencies
pip install -r requirements.txt

# Start the application
python app.py

🔮 Roadmap

Coming Soon

2024 (Q4)

  • 🌐 Multi-language support (Arabic, French).
  • 📱 Mobile app development.
  • 🥗 Advanced nutritional analysis features.

2025 (Q1)

  • 🗣 Voice interaction capabilities.
  • 🖼 AI-powered recipe image generation.
  • 🌍 Community contributions for user-uploaded recipes.

👥 Meet the Team

CuisineRAG is crafted by a passionate team of engineers and food lovers:

  • Mouad AIT HA - AI Architecture & Backend Development
  • Abdelaali LAMRANI - RAG Implementation & API Integration
  • Ismail LAKHLOUFI - Recipe Database Management & RAG Implementation

Made with ❤️ by the CuisineRAG Team

✨ Rediscover Moroccan Cuisine. Reimagine Your Diet.

Your journey to delicious, adaptable recipes starts here. 🍴