Skip to content

Harmeet03/CookVault

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 

Repository files navigation

🍳 CookVault

CookVault is an AI-powered recipe assistant that helps users discover recipes using available ingredients or even fridge images.

Users can:

  • Enter ingredients manually
  • Upload fridge images for ingredient detection
  • Get AI-generated Indian recipe suggestions
  • View matching recipes with ingredient analysis

Built with modern AI workflows and a clean dark-themed UI.

OG-IMAGE


✨ Features

  • 🤖 AI-generated recipe recommendations
  • 📸 Fridge image ingredient detection
  • 🇮🇳 Indian cuisine focused suggestions
  • 🥗 Ingredient-based recipe search
  • 🧠 AI fallback handling
  • ⏳ API timeout handling
  • 🌙 Modern dark-themed responsive UI
  • ⚡ Fast and lightweight frontend
  • 🛡 Privacy Policy, Terms, and AI Disclaimer pages

🧠 How It Works

CookVault follows a multi-step AI pipeline:

User Input / Fridge Image
        ↓
Ingredient Detection (Gemini Vision)
        ↓
Recipe Search (Spoonacular API)
        ↓
AI Recommendation Layer (NVIDIA AI)
        ↓
Formatted Recipe Suggestions

🛠 Tech Stack

Frontend

  • Next.js
  • React
  • TypeScript
  • Tailwind CSS

AI & APIs

  • NVIDIA AI APIs
  • DeepSeek V4 Flash
  • Llama Fallback Model
  • Gemini Vision API
  • Spoonacular API

📸 Core Features

🔍 Ingredient Search

Users can manually enter ingredients to discover matching recipes.

🖼 Fridge Image Upload

Users can upload fridge images and CookVault automatically detects ingredients using AI vision models.

🤖 AI Recipe Suggestions

AI generates beginner-friendly Indian recipes based on:

  • available ingredients
  • recipe matching
  • missing ingredient analysis

🇮🇳 Indian Cuisine Focus

The app prioritizes:

  • Indian household recipes
  • curries
  • sabzis
  • parathas
  • rice dishes
  • Indian-style cooking

⚙️ Installation

Clone the repository:

git clone https://github.com/your-username/cookvault.git

Move into the project directory:

cd cookvault

Install dependencies:

npm install

Run the development server:

npm run dev

🔑 Environment Variables

Create a .env.local file in the root directory.

SPOONACULAR_API_KEY=your_spoonacular_key

NVIDIA_API_KEY=your_nvidia_key

GEMINI_API_KEY=your_gemini_key

📂 Project Structure

app/
 ├── api/
 │    ├── recipe/
 │    └── detect/
 │
 ├── privacy-policy/
 ├── terms/
 ├── disclaimer/
 │
components/
 ├── layout/
 ├── recipe/
 │
lib/
 ├── nvidia.ts
 ├── prompt.ts
 ├── spoonacular.ts
 ├── gemini.ts
 ├── image_prompt.ts
 │
services/
 ├── aiService.ts
 ├── recipeService.ts
 │
types/
 ├── recipe.ts
utils/
 └── withTimeout.ts

🚀 Future Improvements

  • Animated SVG backgrounds
  • AI chat assistant mode
  • Voice input
  • Nutrition analysis
  • Regional Indian cuisine filters
  • Save favorite recipes
  • Authentication system
  • Recipe history
  • AI meal planning

⚠ Disclaimer

AI-generated responses may occasionally contain inaccurate or incomplete cooking suggestions. Users should verify ingredients, allergies, and cooking instructions before use.


📄 Legal

This project includes:

  • Privacy Policy
  • Terms of Service
  • AI Disclaimer

👨‍💻 Author

Made with ❤️ by Harmeet Singh


⭐ Support

If you liked this project, consider giving it a star on GitHub ⭐

About

CookVault is an AI-powered recipe assistant that helps users discover recipes using available ingredients or even fridge images.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors