templates/index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <!--
    Recipe Assistant Bot - Main Interface
    Author: RSK World (https://rskworld.in)
    Founder: Molla Samser
    Designer & Tester: Rima Khatun
    Contact: help@rskworld.in, +91 93305 39277
    Year: 2026
    -->
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Recipe Assistant Bot - RSK World</title>
    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/css/bootstrap.min.css" rel="stylesheet">
    <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css" rel="stylesheet">
    <link href="{{ url_for('static', filename='css/style.css') }}" rel="stylesheet">
</head>
<body>
    <header class="bg-primary text-white py-3">
        <div class="container">
            <div class="row align-items-center">
                <div class="col-md-8">
                    <h1><i class="fas fa-utensils me-2"></i>Recipe Assistant Bot</h1>
                    <p class="mb-0">Your AI-powered cooking companion for recipes, substitutions, and cooking tips</p>
                </div>
                <div class="col-md-4 text-end">
                    <small class="d-block">© 2026 RSK World</small>
                    <small>Developed by Molla Samser & Rima Khatun</small>
                </div>
            </div>
        </div>
    </header>

    <main class="container my-4">
        <div class="row">
            <!-- Chat Section -->
            <div class="col-lg-8">
                <div class="card">
                    <div class="card-header bg-success text-white">
                        <h5 class="mb-0"><i class="fas fa-comments me-2"></i>Chat with Recipe Assistant</h5>
                    </div>
                    <div class="card-body">
                        <div id="chatMessages" class="chat-container mb-3">
                            <div class="message bot-message">
                                <div class="message-content">
                                    <strong>Recipe Bot:</strong> Hello! I'm your recipe assistant. I can help you with:
                                    <ul class="mt-2">
                                        <li>Recipe suggestions</li>
                                        <li>Ingredient substitutions</li>
                                        <li>Cooking tips and techniques</li>
                                        <li>Dietary restriction options</li>
                                    </ul>
                                    What would you like to know today?
                                </div>
                            </div>
                        </div>
                        <div class="input-group">
                            <input type="text" id="messageInput" class="form-control" placeholder="Ask about recipes, ingredients, or cooking tips..." maxlength="500">
                            <button class="btn btn-success" id="sendButton">
                                <i class="fas fa-paper-plane"></i> Send
                            </button>
                        </div>
                        <div class="mt-2">
                            <small class="text-muted">Quick suggestions:</small>
                            <div class="quick-suggestions mt-1">
                                <button class="btn btn-sm btn-outline-secondary me-1 mb-1 quick-suggestion" data-message="Give me a chicken recipe">Chicken Recipe</button>
                                <button class="btn btn-sm btn-outline-secondary me-1 mb-1 quick-suggestion" data-message="What can I substitute for eggs?">Egg Substitutes</button>
                                <button class="btn btn-sm btn-outline-secondary me-1 mb-1 quick-suggestion" data-message="Give me some baking tips">Baking Tips</button>
                                <button class="btn btn-sm btn-outline-secondary me-1 mb-1 quick-suggestion" data-message="Vegetarian recipes">Vegetarian</button>
                                <button class="btn btn-sm btn-outline-primary me-1 mb-1 quick-suggestion" data-message="Create a 7-day meal plan">Meal Plan</button>
                                <button class="btn btn-sm btn-outline-info me-1 mb-1 quick-suggestion" data-message="What's the nutrition for spaghetti carbonara?">Nutrition Info</button>
                                <button class="btn btn-sm btn-outline-success me-1 mb-1 quick-suggestion" data-message="How much does chicken stir fry cost?">Cost Info</button>
                                <button class="btn btn-sm btn-outline-warning me-1 mb-1 quick-suggestion" data-message="Generate a shopping list">Shopping List</button>
                                <button class="btn btn-sm btn-outline-danger me-1 mb-1 quick-suggestion" data-message="Set timer for 15 minutes">Timer</button>
                            </div>
                        </div>
                    </div>
                </div>
            </div>

            <!-- Features Section -->
            <div class="col-lg-4">
                <div class="card mb-3">
                    <div class="card-header bg-warning">
                        <h6 class="mb-0"><i class="fas fa-star me-2"></i>Features</h6>
                    </div>
                    <div class="card-body">
                        <ul class="list-unstyled">
                            <li class="mb-2"><i class="fas fa-check text-success me-2"></i>Recipe suggestions</li>
                            <li class="mb-2"><i class="fas fa-check text-success me-2"></i>Ingredient substitutions</li>
                            <li class="mb-2"><i class="fas fa-check text-success me-2"></i>Cooking tips</li>
                            <li class="mb-2"><i class="fas fa-check text-success me-2"></i>Meal planning</li>
                            <li class="mb-2"><i class="fas fa-check text-success me-2"></i>Dietary restrictions</li>
                            <li class="mb-2"><i class="fas fa-check text-info me-2"></i>Nutritional information</li>
                            <li class="mb-2"><i class="fas fa-check text-info me-2"></i>Cost calculator</li>
                            <li class="mb-2"><i class="fas fa-check text-info me-2"></i>Shopping lists</li>
                            <li class="mb-2"><i class="fas fa-check text-info me-2"></i>Recipe ratings</li>
                            <li class="mb-2"><i class="fas fa-check text-info me-2"></i>Favorites & bookmarks</li>
                            <li class="mb-2"><i class="fas fa-check text-warning me-2"></i>Cooking timer</li>
                            <li class="mb-2"><i class="fas fa-check text-warning me-2"></i>Recipe sharing</li>
                        </ul>
                    </div>
                </div>

                <div class="card mb-3">
                    <div class="card-header bg-info text-white">
                        <h6 class="mb-0"><i class="fas fa-info-circle me-2"></i>About</h6>
                    </div>
                    <div class="card-body">
                        <p class="small">This chatbot helps with cooking by providing recipes, ingredient substitutions, cooking tips, and meal planning. Perfect for food apps and cooking platforms.</p>
                        <hr>
                        <p class="small mb-1"><strong>Technologies:</strong></p>
                        <div class="mb-2">
                            <span class="badge bg-primary me-1">Python</span>
                            <span class="badge bg-primary me-1">Flask</span>
                            <span class="badge bg-primary me-1">Recipe APIs</span>
                            <span class="badge bg-primary me-1">OpenAI API</span>
                        </div>
                        <p class="small mb-1"><strong>Difficulty:</strong> <span class="badge bg-success">Beginner</span></p>
                    </div>
                </div>

                <div class="card">
                    <div class="card-header bg-secondary text-white">
                        <h6 class="mb-0"><i class="fas fa-phone me-2"></i>Contact</h6>
                    </div>
                    <div class="card-body">
                        <p class="small mb-1"><strong>RSK World</strong></p>
                        <p class="small mb-1">Founder: Molla Samser</p>
                        <p class="small mb-1">Designer & Tester: Rima Khatun</p>
                        <p class="small mb-1">Email: <a href="mailto:help@rskworld.in">help@rskworld.in</a></p>
                        <p class="small mb-1">Phone: <a href="tel:+919330539277">+91 93305 39277</a></p>
                        <p class="small mb-0">Website: <a href="https://rskworld.in" target="_blank">rskworld.in</a></p>
                    </div>
                </div>
            </div>
        </div>
    </main>

    <footer class="bg-dark text-white py-3 mt-5">
        <div class="container">
            <div class="row">
                <div class="col-md-6">
                    <p class="mb-0">© 2026 RSK World. All rights reserved.</p>
                    <p class="mb-0">Nutanhat, Mongolkote, Purba Burdwan, West Bengal, India - 713147</p>
                </div>
                <div class="col-md-6 text-end">
                    <p class="mb-0">Developed by Molla Samser & Rima Khatun</p>
                    <p class="mb-0">Educational Purpose Project</p>
                </div>
            </div>
        </div>
    </footer>

    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/js/bootstrap.bundle.min.js"></script>
    <script src="{{ url_for('static', filename='js/chat.js') }}"></script>
</body>
</html>

160 lines•9.6 KB

markup

RELEASE_NOTES.md

Raw Download

RELEASE_NOTES.md

# Release Notes - Recipe Assistant Bot

## Version 1.0.0 - Initial Release
**Release Date:** January 9, 2026
**GitHub Repository:** [rskworld/recipe-assistant-bot](https://github.com/rskworld/recipe-assistant-bot)

---

## 🎉 Welcome to Recipe Assistant Bot!

A comprehensive AI-powered cooking assistant chatbot with advanced features for recipe management, meal planning, ingredient tracking, and smart kitchen integration.

---

## ✨ Core Features

### 🍳 Recipe Management
- **Recipe Search & Discovery**: Find recipes by ingredients, cuisine, dietary restrictions
- **Recipe Details**: Comprehensive recipe information with ingredients, instructions, and nutrition
- **Recipe Scaling**: Automatically scale recipes to different serving sizes
- **Recipe Variations**: Generate cuisine variations (Italian, Mexican, Asian, etc.), dietary alternatives (vegan, gluten-free, keto), and spice level adjustments
- **Recipe Collections**: Create custom cookbooks and organize recipes into collections

### 🤖 AI-Powered Features
- **Smart Chatbot**: Natural language processing for recipe queries
- **Cooking Assistant**: Step-by-step AI-guided cooking sessions
- **Recipe Recommendations**: Personalized recipe suggestions based on preferences
- **Leftover Suggestions**: Find recipes based on available ingredients

### 📦 Ingredient Management
- **Inventory Tracking**: Track ingredients with expiry dates, quantities, and storage locations
- **Shopping Lists**: Generate shopping lists from recipes with price estimation
- **Expiry Alerts**: Get notified about expiring ingredients
- **Recipe Matching**: Find recipes based on your current inventory

### 📅 Meal Planning
- **Meal Prep Planning**: Create weekly meal prep plans with batch cooking schedules
- **Personalized Meal Plans**: AI-generated meal plans based on dietary preferences
- **Prep Timeline**: Step-by-step meal prep timeline with storage instructions
- **Nutrition Tracking**: Track daily nutrition goals and progress

### 🏆 Gamification
- **Cooking Challenges**: Create and participate in cooking challenges
- **Achievement Badges**: Earn badges for completing recipes and challenges
- **Cooking Statistics**: Track your cooking journey with detailed stats
- **Progress Tracking**: Monitor your cooking streak and milestones

### 🏠 Smart Kitchen Integration
- **Device Control**: Integrate with smart kitchen devices (ovens, scales, thermometers)
- **Cooking Sessions**: Real-time monitoring and control of cooking devices
- **Automation Rules**: Create automation rules for smart devices
- **Device Analytics**: Track device usage and efficiency

### 🎤 Voice Assistant
- **Voice Commands**: Control the bot with voice commands
- **Text-to-Speech**: Get recipe instructions read aloud
- **Voice Search**: Search recipes using voice
- **Hands-free Cooking**: Cook without touching your device

### 📸 Image Recognition
- **Recipe from Image**: Generate recipes from food images
- **Ingredient Detection**: Identify ingredients from photos
- **Recipe Recognition**: Recognize recipes from ingredient images

### ⭐ Reviews & Ratings
- **Recipe Reviews**: Rate and review recipes
- **Detailed Feedback**: Provide pros, cons, and detailed comments
- **Recipe Statistics**: View recipe ratings and statistics
- **Helpful Votes**: Mark reviews as helpful

---

## 🚀 Advanced Features (New in v1.0.0)

### Recipe Operations
- Recipe scaling for any serving size
- Recipe variations generator
- Leftover ingredient recipe suggestions

### Inventory Management
- Complete inventory tracking system
- Expiry date management
- Location-based organization (pantry, fridge, freezer)
- Recipe suggestions from inventory

### Collections & Cookbooks
- Custom recipe collections
- Public/private collections
- Tag-based organization
- Collection sharing

### Cooking Challenges
- Weekly recipe challenges
- Technique mastery challenges
- Cuisine exploration challenges
- Progress tracking and rewards

### Meal Prep Planning
- Weekly meal prep schedules
- Batch cooking recommendations
- Storage instructions
- Prep timeline management

### Statistics & Tracking
- Cooking statistics dashboard
- Recipe history tracking
- Cooking streaks
- Favorite cuisine tracking

---

## 📋 API Endpoints

### Recipe Endpoints
- `GET /api/recipes` - Get recipe suggestions
- `POST /api/recipe/scale` - Scale recipe servings
- `POST /api/recipe/variations` - Get recipe variations
- `POST /api/recipe/leftover-suggestions` - Get leftover recipes

### Chat & Search
- `POST /api/chat` - Chat with AI assistant
- `POST /api/search` - Search recipes

### Inventory
- `GET /api/inventory` - Get inventory
- `POST /api/inventory/add` - Add to inventory
- `PUT /api/inventory/update` - Update inventory
- `DELETE /api/inventory/remove` - Remove from inventory
- `GET /api/inventory/recipes` - Get recipes from inventory

### Collections
- `GET /api/collections` - Get collections
- `POST /api/collections` - Create collection
- `POST /api/collections/<id>/recipes` - Add recipe to collection

### Challenges
- `GET /api/challenges` - Get challenges
- `POST /api/challenges` - Create challenge
- `POST /api/challenges/<id>/complete` - Complete challenge recipe

### Meal Prep
- `POST /api/meal-prep/create` - Create meal prep plan

### Statistics
- `GET /api/stats/cooking` - Get cooking statistics
- `POST /api/stats/track-recipe` - Track cooked recipe

### And many more... (70+ endpoints total)

---

## 🛠️ Technology Stack

- **Backend**: Python 3.8+, Flask 2.3.3
- **Frontend**: HTML5, CSS3, JavaScript, Bootstrap 5
- **APIs**: Recipe APIs, OpenAI API (optional)
- **Database**: SQLite (default), configurable
- **Additional**: Flask-CORS, Requests, Python-dotenv

---

## 📦 Installation

```bash
# Clone the repository
git clone https://github.com/rskworld/recipe-assistant-bot.git
cd recipe-assistant-bot

# Create virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run the application
python run.py
```

---

## 📚 Documentation

- **README.md** - Complete project documentation
- **ADVANCED_FEATURES.md** - Advanced features documentation
- **ERROR_CHECK_REPORT.md** - Code quality report
- **API Documentation** - Available in routes.py

---

## 👥 Credits

**Author:** RSK World
**Website:** [rskworld.in](https://rskworld.in)
**Founder:** Molla Samser
**Designer & Tester:** Rima Khatun
**Contact:** help@rskworld.in, +91 93305 39277
**Location:** Nutanhat, Mongolkote, Purba Burdwan, West Bengal, India - 713147

---

## 📄 License

This project is created for educational purposes by RSK World. Content used for educational purposes only.

---

## 🌟 Features Overview

- ✅ 70+ API Endpoints
- ✅ Advanced Recipe Management
- ✅ AI-Powered Cooking Assistant
- ✅ Ingredient Inventory System
- ✅ Meal Prep Planning
- ✅ Smart Kitchen Integration
- ✅ Cooking Challenges & Gamification
- ✅ Recipe Collections & Cookbooks
- ✅ Voice Assistant Integration
- ✅ Image Recognition
- ✅ Reviews & Ratings System
- ✅ Nutrition Tracking
- ✅ Shopping List Generation
- ✅ Recipe Scaling & Variations
- ✅ Leftover Recipe Suggestions

---

## 🔮 Future Enhancements

- Database migration for persistent storage
- Real-time notifications
- Social sharing features
- Recipe video integration
- Enhanced AI recommendations
- Mobile app development
- Recipe cost calculator
- Seasonal recipe suggestions

---

## 📞 Support

- **Website:** https://rskworld.in
- **Email:** help@rskworld.in
- **Phone:** +91 93305 39277

---

**© 2026 RSK World. All rights reserved.**
*Educational Purpose Project*

Theme Settings

Color Scheme

Display Options

Font Size

RELEASE_NOTES.md