🍰 BakeGenuis 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)

---

Setup Instructions 📥

🛠️ 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 BakeGenius-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.

---

📌 How to Get Involved & Contribute

👩‍💻 Want to contribute to BakeGenius AI and become part of the open-source family? It’s super easy! 🚀
We welcome contributions from all levels – beginners and experts alike.

✅ Steps to Get Started:

1. 🔧 Follow the Setup Instructions to run the project locally.
2. 🌐 Explore the live preview:
   👉 BakeGenius-AI Preview Link
3. 🐛 Found a bug or want to suggest UI/UX improvements?
   • Open an Issue in the repository.
   • It will be assigned to you for contribution.
4. 🌟 Want to contribute features or fix bugs?
   • Pick issues labeled good first issue for easy contributions.
   • Suggest or build new features such as:
     • Improving AI prompt engineering
     • Adding ingredient density data
     • Enhancing UI components or responsiveness
5. 🧱 Fork the project, make your changes, and submit a Pull Request.

---

💡 Pro Tips:

• Fix typos, improve documentation, or optimize code – every contribution counts!
• Write clear and meaningful commit messages to help maintain project clarity.

❤️ Thank you for contributing and making BakeGenius AI awesome!
Let’s grow together — one PR at a time. 🌱

---

🤝👤 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 have 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 BakeGenius-AI today! 🚀