Flavor AI

Welcome to FlavorAI, your AI-powered culinary companion! This project is designed to make meal planning and recipe exploration effortless and fun. Whether you're looking for AI-curated recipes, diverse food categories, or exciting culinary surprises, FlavorAI has it all.

📊 Project Insights

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

🚀 Features

• AI-Curated Recipes: Generate recipes tailored to your preferences.
• AI Diet Planner: Get personalized daily meal plans based on your health profile and fitness goals.
• Ingredient Image Analysis: Upload photos of available ingredients for smart recipe suggestions.
• Random Recipe Discovery: Discover a surprise recipe at the click of a button.
• Diverse Meal Categories: Browse through various categories like Beef, Chicken, Desserts, and more.
• Responsive Design: Optimized for devices of all sizes.
• Dynamic Search: Quickly find recipes with the integrated search bar.
• Voice Input: Use voice commands to describe your desired recipe.
• Text-to-Speech: Listen to recipe instructions while cooking.
• Smart Filtering: Filter recipes by dietary restrictions and cuisine types.
• Festive Recipe: Get recipes of festivals
• Favourites: You can save your favourite recipes
• Toggle Theme: Seamlessly switch between light and dark modes for good viewing experience.
• Language Selector: Easily switch the app’s language for a personalized experience supports native languages too.
• Community Recipes:xplore and contribute user-submitted recipe and discover dishes.

🎯 Key Functionalities

1. Recipe Generation

   • Describe your desired dish
   • Upload images of available ingredients
   • Set dietary restrictions
   • Choose cuisine type
   • Adjust spice levels
   • Get AI-generated recipes with images

2. AI Diet Planner

   • Personalized daily meal plans
   • Health-conscious recommendations based on blood sugar and blood pressure
   • Fitness goal alignment (bulk, cut, maintain, general health)
   • Nutritional breakdown for each meal
   • BMR and TDEE calculations
   • Dietary restrictions and allergy considerations
   • Exercise and hydration recommendations

3. Recipe Search

   • Quick search functionality
   • Category-based browsing
   • Random recipe discovery
   • Detailed recipe views
   • voice support for recipe serch

4. Accessibility Features

   • Voice input for hands-free operation
   • Text-to-speech for recipe instructions
   • Responsive design for all devices
   • Clear, readable typography

🌟 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 Flavor-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 Flavor-ai project family! Let's build, learn, and grow together — one commit at a time. 🔥👨‍💻👩‍💻

Screenshots

Here are some screenshots of the project in action:

Screenshot 1	Screenshot 2

Screenshot 3	Screenshot 4

🖥️ Tech Stack

• Frontend: Next.js
• Backend: Fetches data from a custom API
• Styling: Tailwind CSS, DaisyUI
• AI Integration: OpenAI/Groq API
• Hosting: Vercel

📦 Installation & Setup

• Clone repository git clone https://github.com/Ayushjhawar8/flavor-ai.git

• Navigate to project folder cd flavor-ai

• Install dependencies npm install

• Add environment keys cp .env.sample .env.local

• Then add: GROQ_API_KEY=your_api_key_here

• GOOGLE_GENERATIVE_AI_API_KEY=your_google_gemini_api_key_here

• Run development server npm run dev

5. Open http://localhost:3000 in your browser.

🎨 Project Structure

flavor-ai/
├── public/                     # Static assets (images, icons, logos)
│   └── ...
│
├── src/
│   ├── app/                    # Core Next.js routing and pages
│   │   ├── (features)/         # Grouped feature routes
│   │   │   ├── ai-generator/   # AI recipe generation pages
│   │   │   ├── diet-planner/   # AI diet planner interface
│   │   │   ├── discovery/      # Random recipe + search
│   │   │   └── community/      # User-shared recipes
│   │   ├── api/                # API routes (server functions)
│   │   ├── layout.tsx          # Main layout wrapper
│   │   └── page.tsx            # Homepage
│   │
│   ├── components/             # Global UI components
│   │   ├── ui/                 # Base UI (buttons, inputs, cards)
│   │   ├── common/             # Navbar, Footer, Sidebar, etc.
│   │   └── modals/             # Dialogs, alerts, etc.
│   │
│   ├── features/               # Independent functional modules
│   │   ├── ai-generator/       # Components & hooks for AI recipe creation
│   │   ├── diet-planner/       # Components, services, hooks for meal plans
│   │   ├── recipe-discovery/   # Search, FilterPanel, RecipeCards
│   │   └── community/          # Recipe upload, validation, display
│   │
│   ├── hooks/                  # Reusable custom React hooks
│   │   ├── useTheme.ts         # Light/Dark mode management
│   │   ├── useVoiceInput.ts    # Handle microphone inputs
│   │   └── useSpeech.ts        # Manage text-to-speech
│   │
│   ├── lib/                    # Utility modules and constants
│   │   ├── api/                # Groq/Gemini API handlers
│   │   ├── utils.ts            # Shared helper functions
│   │   └── constants.ts        # App-wide constants
│   │
│   ├── styles/                 # Global Tailwind and custom styles
│   │   └── globals.css
│   │
│   └── types/                  # Global TypeScript definitions
│       ├── recipe.ts           # Recipe-related types
│       ├── user.ts             # User and profile interfaces
│       └── index.ts
│
├── .env.local                  # API keys and environment variables
├── next.config.mjs
├── package.json
└── tsconfig.json

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

🙏 Acknowledgments

• Built with Next.js, CodeBuff
• Styled with Tailwind CSS
• UI components from DaisyUI
• AI powered by Groq

🎥 Demo

📜 Code of Conduct

Please refer to the Code of Conduct for details on contributing guidelines and community standards.

🤝👤 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 Flavor-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:

Ayush Jhawar

👨‍🏫 Mentors – Flavor-ai (GSSoC'25)

Role	Name	GitHub Profile	LinkedIn Profile
Mentor 1	Anshika Sansanwal	anshikasansanwal	anshikasansanwal
Mentor 2	Zala Vishvarajsinh Krushnpalsinh	Zala0007	vishvarajsinh-zala
Mentor 3	Krish Ahlawat		krishahlawat
Mentor 4	Kanishka		kanishka-tyagi
Mentor 5	Arnab Laha	LahaArnab	arnab-laha

Give us a Star and let's make magic!

👨‍💻 Built with ❤️ by Flavor-ai Team

❤️ Ayush Jhawar and Contributors ❤️ open an issue | Watch Demo

Ready to show off your coding achievements? Get started with Flavor-ai today! 🚀