🍰 BakeGenius AI - Precision Baking for Everyone

---

BakeGenius AI is an AI-powered tool that transforms vague recipe measurements like "1 cup of flour" or "2 tablespoons of butter" into precise gram-based values. It helps home cooks, professionals, and culinary enthusiasts bake with consistency and accuracy by removing the guesswork from measurements.

⚡ "BakeGenius AI bridges the gap between casual cooking and scientific precision."

---

---

🌟 Stars	🍴 Forks	🐛 Issues	🔔 Open PRs	🔕 Closed PRs	🛠️ Languages	👥 Contributors

---

🧠 Project Objective

Many online recipes list ingredients using vague units like cups, teaspoons, and spoons, which can vary depending on the ingredient and person measuring. This inconsistency often leads to failed recipes.

BakeGenius AI solves this by:

• Converting units like "cups", "tablespoons", etc., into exact grams.
• Using a built-in database of ingredient densities.
• Supporting voice-based input, real-time AI assistance, and visualizations.
• Empowering bakers with consistent, professional results every time.

---

🚀 Features

✅ Convert vague units to precise gram measurements
✅ Smart ingredient detection using Natural Language Processing (NLP)
✅ Ingredient density database for accurate conversions
✅ Real-time conversion engine using Gemini API
✅ Voice input: Speak your recipe and get precise outputs
✅ Clean and user-friendly interface
✅ Visualizations: Show side-by-side conversions and measurement charts
✅ Open Source – Easy to contribute and extend

---

🎯 Open Source Programmes ⭐

This project is now OFFICIALLY accepted for:

🌟 Exciting News...

🚀 This project is now an official part of GirlScript Summer of Code – GSSoC'25! 💃🎉💻 We're thrilled to welcome contributors from all over India and beyond to collaborate, build, and grow BakeGenuis-AI! Let’s make learning and career development smarter – together! 🌟👨‍💻👩‍💻

👩‍💻 GSSoC is one of India’s largest 3-month-long open-source programs that encourages developers of all levels to contribute to real-world projects 🌍 while learning, collaborating, and growing together. 🌱

🌈 With mentorship, community support, and collaborative coding, it's the perfect platform for developers to:

• ✨ Improve their skills
• 🤝 Contribute to impactful projects
• 🏆 Get recognized for their work
• 📜 Receive certificates and swag!

🎉 I can’t wait to welcome new contributors from GSSoC 2025 to this BakeGenuis-AI project family! Let's build, learn, and grow together — one commit at a time. 🔥👨‍💻👩‍💻

---

🔧 Tech Stack

• Frontend: HTML, CSS, JavaScript
• AI API: Gemini API by Google (for language understanding and smart suggestions)

---

📊 Example Conversion

Input	Output (in grams)
1 cup of sugar	200g
2 tablespoons of butter	28g
½ cup of milk	122g
1 tsp of baking soda	4.8g

(values vary depending on the density of ingredients)

---

🛠️ How to Run Locally

1. Clone the repository:

git clone https://github.com/supriya46788/BakeGenuis-AI.git
cd BakeGenuis-AI

🔑 Firebase Configuration

Update your Firebase SDK configuration in the file:

js/firebase.js

To enable Google Sign-In and other Firebase services, update your Firebase SDK configuration inside the project:

// Firebase Config
const firebaseConfig = {
  apiKey: "YOUR_API_KEY",  
  authDomain: "YOUR_AUTH_DOMAIN",  
  projectId: "YOUR_PROJECT_ID",  
  storageBucket: "YOUR_STORAGE_BUCKET",  
  messagingSenderId: "YOUR_MESSAGING_SENDER_ID",  
  appId: "YOUR_APP_ID",  
  measurementId: "YOUR_MEASUREMENT_ID"  
};

2. Open the index.html file in any browser to run the app.

3. Ensure Gemini API keys are correctly added in your JS code.

---

📥 Submitting a Pull Request

Follow these steps to contribute your changes to BakeGenuis-AI:

1. 🌟 Star & Fork the Repository
   Click the “Star” button to support the project, then “Fork” the repo to create your own copy:
   👉 https://github.com/supriya46788/BakeGenuis-AI

2. 📥 Clone Your Fork
   Use the following command to clone your forked repository to your local machine:

   git clone https://github.com/Your-Username/BakeGenuis-AI.git

3. Create a Branch Navigate to the project directory and create a new branch for your changes:

   cd BakeGenuis-AI
   git checkout -b my-feature-branch

4. Make Changes Add your new ML projects, games, websites, or enhancements. Fix bugs or improve UI/UX as needed.

5. Commit Your Changes Use a meaningful commit message:

   git add .
   git commit -m "📦 [Feature Add] Add XYZ website project"

6. Push Your Changes Push your branch to your GitHub fork:

   git push origin my-feature-branch

7. Submit a Pull Request

   Go to your fork on GitHub.

   Click "Compare & pull request".

   Add a descriptive title using one of the prefixes: [UI], [UX], [Feature Add].

   Link the related issue (if any) and clearly describe your changes.

---

🤝 Contributing

We welcome contributions from the community!
Here’s how you can help:

• 📌 Raise issues or bug reports
• 🌟 Suggest new features
• 🧪 Improve AI prompt engineering or ingredient logic
• 🎨 Enhance UI/UX

---

🤝👤 Contribution Guidelines

We love our contributors! If you'd like to help, please check out our CONTRIBUTE.md file for guidelines.

Thank you once again to all our contributors who has contributed to BakeGenuis-AI! Your efforts are truly appreciated. 💖👏

See the full list of contributors and their contributions on the GitHub Contributors Graph.

Show some by starring this awesome repository!

---

💡 Suggestions & Feedback

Feel free to open issues or discussions if you have any feedback, feature suggestions, or want to collaborate!

---

🙌 Support & Star

If you find this project helpful, please give it a star! ⭐ to support more such educational initiatives!

---

📄 License

This project is licensed under the MIT License - see the License file for details.

---

⭐ Stargazers

---

🍴 Forkers

---

🧑‍💻Project Admin:

Supriya

---

👨‍💻 Developed By ❤️ Supriya and Contributors ❤️ open an issue | Watch Demo

---

---

Ready to show off your coding achievements? Get started with BakeGenuis-AI today! 🚀