An AI-powered gourmet custom recipe generator built using Python Flask, JavaScript, CSS Glassmorphism, and Google Gemini AI. Enter available pantry ingredients with quantities, select dietary preferences, and instantly receive custom recipes complete with interactive cooking step timers, nutrition macros, and alternative equipment & pantry substitutions formatted with slashes /.
👉 Click Here to Open the Live Project: https://custom-receipe-generator.vercel.app/
| Category | Technology | Description |
|---|---|---|
| AI Engine |  |
Generates customized gourmet recipes, validates food items, and provides alternative equipment substitutions (/). |
| Backend |   |
REST API endpoints (/api/generate-recipe, /api/status), prompt engineering, and environment routing. |
| Frontend |    |
Luxury Glassmorphism dark theme, dynamic ingredient builder, interactive checklist, and step timer widgets. |
| Typography & Icons |   |
Plus Jakarta Sans & Playfair Display typography paired with culinary iconography. |
| Deployment |   |
Vercel Python Serverless Functions with automatic GitHub deployment pipeline. |
- 🍳 Dynamic Ingredient Builder: Input ingredients with custom quantities and units, or use quick-add pantry staple tags.
- 🤖 AI Ingredient Validation: Automatically verifies if input items are valid, edible food items. Prompts for retry if non-food items are entered.
- 🔀 Smart Alternate Substitutions (
/): Provides equipment and pantry staple alternatives (e.g. Frying Pan / Non-stick Skillet, Salt / Sea Salt) if standard cookware isn't available. - ⏱️ Interactive Cooking Checklist & Timer: Check off cooking steps as you cook with built-in step countdown timers.
- 📊 Nutritional Macros: View estimated protein, carbs, fat, and total calories per serving.
- 🔒 Secure API Key Management: API key is isolated inside
.envand kept local using.gitignore.
Important
Never commit your API key to GitHub. The .env file is excluded from Git tracking via .gitignore.
Create a file named .env in the root folder (do not push this to GitHub):
GEMINI_API_KEY=YOUR_ACTUAL_GEMINI_API_KEY_HEREDevelopers cloning this repo should copy .env.example to .env:
cp .env.example .env- Python 3.10+
- Google Gemini API Key (Get a free key at Google AI Studio)
# 1. Clone the repository
git clone https://github.com/PavanReddy666/Custom-Receipe-Generator.git
cd Custom-Receipe-Generator
# 2. Install dependencies
pip install -r requirements.txt
# 3. Create .env file and add your key
echo "GEMINI_API_KEY=your_gemini_api_key_here" > .env
# 4. Run the Flask application
python app.pyOpen your browser and navigate to http://127.0.0.1:5000 or access the live deployment at https://custom-receipe-generator.vercel.app/.
We welcome contributions from the community! If you'd like to collaborate, add new features, or join as a contributor:
- Fork this repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- PavanReddy666 - Creator & Lead Maintainer
Custom-Receipe-Generator/
├── app.py # Main Flask Backend & Gemini AI integration
├── requirements.txt # Python dependencies
├── .env # Local API Key (Ignored by Git)
├── .env.example # Environment template for repository
├── .gitignore # Excludes secret & temporary files
├── static/
│ ├── css/
│ │ └── style.css # Glassmorphic dark styling & layout
│ ├── js/
│ │ └── app.js # Dynamic client application logic
│ └── favicon.svg # Gourmet Fork SVG logo icon
└── templates/
└── index.html # Single Page Application HTML structure
Distributed under the MIT License. See LICENSE for more information.