https://github.com/theadhithyankr/cookwithwhatyouhave
Turn your ingredients into instant recipes using AI – complete with step-by-step instructions, timers, and nutritional breakdowns.
https://github.com/theadhithyankr/cookwithwhatyouhave
ai-cooking food-ingredients gemini-api nextjs nutrition-app react recipe-generator webapp
Last synced: about 1 month ago
JSON representation
Turn your ingredients into instant recipes using AI – complete with step-by-step instructions, timers, and nutritional breakdowns.
- Host: GitHub
- URL: https://github.com/theadhithyankr/cookwithwhatyouhave
- Owner: theadhithyankr
- Created: 2025-04-11T09:47:08.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-04-11T09:55:33.000Z (about 1 month ago)
- Last Synced: 2025-04-11T11:51:15.208Z (about 1 month ago)
- Topics: ai-cooking, food-ingredients, gemini-api, nextjs, nutrition-app, react, recipe-generator, webapp
- Language: TypeScript
- Homepage:
- Size: 146 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🍳 Cook With What You Have
**Cook With What You Have** is a smart recipe generator web app that helps you turn the ingredients in your kitchen into delicious meals. Powered by the Gemini API, the app not only generates step-by-step recipes, but also provides detailed macro and micronutrient breakdowns — all while letting you check off each step and use built-in timers for a seamless cooking experience.
---
## 🌟 Features
- 🥦 **Ingredient-Based Recipe Generation**
Enter the ingredients you have — get a full recipe instantly using the Gemini API.
- 📋 **Step-by-Step Instructions**
Clear instructions with checkboxes to mark your progress.
- ⏲️ **Timers for Each Step**
Integrated timers so you never overcook or miss a step.
- 🍽️ **Macro & Micronutrient Breakdown**
See detailed nutritional info for the full recipe.
---
## 🚀 How It Works
1. Enter a list of available ingredients.
2. The app uses the **Gemini API** to generate a suitable recipe.
3. It displays the recipe with:
- Step checkboxes
- Timers for each cooking step
- Nutritional data (macros and micros)
---
## 🛠 Tech Stack
- **Frontend**: HTML, CSS, JavaScript (React)
- **Backend**: Gemini API (for recipe generation and nutritional analysis)
- **Other Tools**: Timer functions, local state management
---
## 🔧 Installation
```bash
git clone https://github.com/yourusername/cook-with-what-you-have.git
cd cook-with-what-you-have
npm install
npm start