Skip to content

kalviumcommunity/Byte-2-Bite_MayurKSetty_S68_GenAI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🍽️ Byte-2-Bite — AI-Powered Recipe Generator

Build Status License: MIT Pages Status

Byte-2-Bite is a smart, intuitive AI recipe generator designed to help users decide what to cook based on the ingredients they already have and the cuisine they crave. Built using Gemini Studio, this project seamlessly combines Prompt Engineering, Retrieval-Augmented Generation (RAG), Structured Outputs, and Function Calling to deliver accurate, creative, and delicious recipe suggestions.


🚀 Features

  • 🧠 Prompting: Custom-designed prompts ensure clear understanding of user intent — whether listing ingredients or specifying a cuisine.

  • 📚 RAG (Retrieval-Augmented Generation): Integrates dynamic retrieval from a curated recipe database and external culinary sources.

  • 📦 Structured Output: Consistent JSON schema for each recipe with fields like:

    • title
    • ingredients
    • instructions
    • prep_time
    • cook_time
    • cuisine
    • difficulty
  • 🔧 Function Calling: Modular operations for fetching, filtering, and regenerating recipe options.

  • 🌐 GitHub Pages: Live demo hosted at Byte-2-Bite.


🧑‍🍳 How It Works

  1. Input Ingredients: User enters available ingredients.

  2. Select Cuisine (optional): Choose from various cuisines (e.g., Italian, Indian, Korean).

  3. AI Generation: Gemini processes inputs with structured prompts and retrieves recipes via RAG.

  4. Structured Display: Recipes rendered in a clear JSON format on the UI.

  5. Optional Actions:

    • 🔄 Regenerate new recipes
    • 💾 Save/share favorites
    • ⚖️ Filter by dietary preferences (vegan, gluten-free, etc.)

🛠️ Technologies Used

  • Gemini Studio — Core AI orchestration platform
  • Prompt Engineering — Tailored prompts for high-fidelity responses
  • Retrieval-Augmented Generation — Integrating external recipe data
  • Function Calling — Controlled, modular API-like operations
  • Structured Output APIs — Consistent recipe JSON schema
  • React & Tailwind CSS — Frontend UI
  • GitHub Actions — CI/CD for build & Pages deployment

📁 Example Structured Output

{
  "title": "Creamy Tomato Basil Pasta",
  "ingredients": [
    "Pasta",
    "Tomatoes",
    "Garlic",
    "Basil",
    "Cream",
    "Salt",
    "Olive Oil"
  ],
  "instructions": "Boil pasta. Sauté garlic and tomatoes in olive oil. Add cream and basil. Mix with pasta. Serve hot.",
  "cuisine": "Italian",
  "prep_time": "10 minutes",
  "cook_time": "20 minutes",
  "difficulty": "Easy"
}

⚙️ Project Setup & Deployment

  1. Clone the repo:

    git clone https://github.com/kalviumcommunity/Byte-2-Bite_MayurKSetty_S68_GenAI.git
    cd byte-2-bite
  2. Install dependencies:

    npm install
  3. Configure Gemini Studio:

    • Set your API credentials in ./config/gemini.json.
  4. Run locally:

    npm start
  5. Deploy to GitHub Pages:

    npm run build
    npm run deploy

View live demo at: Byte-2-Bite


📸 UI Mockups

Home Screen Mockup: Screenshot 2025-08-08 at 4 05 48 PM

Recipe Results Mockup: Screenshot 2025-08-08 at 4 06 13 PM


🤝 Contributing

Contributions are welcome! To contribute:

  1. Fork the repo
  2. Create a feature branch (git checkout -b feature/YourFeature)
  3. Commit your changes (git commit -m 'Add YourFeature')
  4. Push to the branch (git push origin feature/YourFeature)
  5. Open a Pull Request

We appreciate ideas for new features (meal planning, calorie tracking, grocery integration).


📜 License

This project is licensed under the MIT License. See the LICENSE file for details.


📣 Future Improvements

  • 🎤 Voice-based input
  • 🌎 Multi-language support
  • 🔖 User accounts & bookmarks
  • 🛒 Integration with grocery APIs

About

Byte-2-Bite is an AI recipe generator

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published