Transform your ingredients into culinary masterpieces with AI-powered recipe generation.

FlavorCraft is an intelligent recipe generator that turns your available ingredients into personalized, delicious recipes. Whether you're a beginner cook or a seasoned chef, FlavorCraft helps you create amazing meals without the guesswork.

• 📸 Photo Recognition: Snap a photo of your ingredients and let AI identify them instantly
• 🤖 AI-Powered Recipes: Get personalized recipes crafted by advanced AI based on what you have
• ⏰ Time-Conscious: Filter recipes by cooking time to match your schedule perfectly
• 🥗 Dietary Friendly: Accommodates all dietary preferences and restrictions seamlessly
• 🌍 Cuisine Variety: Explore recipes from different cuisines around the world
• 📱 No Registration Required: Start cooking immediately without creating an account

• Node.js 18+
• npm or yarn
• A Google Gemini API key
• A Google Vision API key

1. Clone the repository

   git clone https://github.com/TheAgencyMGE/flavor-craft-ai.git
   cd flavor-craft-ai

2. Install dependencies

   npm install

3. Set up environment variables

   cp .env.example .env

   Then edit .env and add your API keys:

   VITE_GEMINI_API_KEY=your_gemini_api_key_here
   VITE_VISION_API_KEY=your_vision_api_key_here
   

4. Start the development server

   npm run dev

5. Open your browser to http://localhost:8080

• Frontend: React 18, TypeScript, Vite
• UI Framework: shadcn/ui, Tailwind CSS
• AI Integration: Google Gemini AI, Google Vision API
• Animations: Framer Motion
• Icons: Lucide React

1. Input Your Ingredients: Either type them manually or take a photo for automatic recognition
2. Set Your Preferences: Choose dietary restrictions, cooking time, skill level, and cuisine
3. Generate Recipe: Our AI analyzes your inputs and creates a personalized recipe
4. Cook & Enjoy: Follow the detailed instructions with nutritional information

1. Google Gemini API Key:

   • Visit Google AI Studio
   • Create a new API key
   • Copy the key to your .env file

2. Google Vision API Key:

   • Visit Google Cloud Console
   • Enable the Vision API
   • Create credentials and copy the API key to your .env file

We welcome contributions! Please feel free to submit a Pull Request.

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

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

FlavorCraft can generate recipes for any combination of ingredients, including:

• Quick Meals (under 30 minutes)
• Healthy Options (low-calorie, high-protein)
• Dietary Specific (vegan, keto, gluten-free)
• International Cuisines (Italian, Asian, Mediterranean)
• Comfort Food (hearty, satisfying meals)

If you encounter any issues or have questions, please open an issue on GitHub.

Happy Cooking! 👨‍🍳👩‍🍳