Web App Image

Team Members:

[Ariya Mathrawala] (https://github.com/ariyamath29) [Nikita Bhaskar] (https://github.com/nikitabhaskar) [Jonathan Gao] (https://github.com/jg169) [Ethan Zheng] (https://github.com/ez2146)

Recipe Generator Web Application

A web application that generates personalized recipes based on available ingredients and health goals using AI.

Project Structure

/web-app/              # Main application directory
├── app.py            # Flask application
├── mlclient.py       # AI/ML integration
├── test_app.py       # Tests
├── templates/        # HTML templates
│   └── index.html   # Main page
├── static/          # Static files (CSS, JS, etc.)
└── .env            # Environment variables (not in git)

Prerequisites

Install the following software on your machine:

• Docker
• Docker Compose
• Python 3.8+
• Git
• MongoDB

Configuration

1. Clone the repository:

git clone https://github.com/software-students-spring2025/5-final-bten.git
cd 5-final-bten

Run with Docker:

1. Build and Run

docker-compose-up --build

2. Run Tests

docker exec -it . pytest

Access the web interface at http://127.0.0.1:3000

Run without Docker:

1. Virtual Environment Setup

Using pipenv:**

pip install pipenv
pipenv shell

Using venv:**

python3 -m venv .venv
source .venv/bin/activate #On Mac
.venv\Scripts\activate.bat #On Windows

2. Install Dependencies

pip install -r requirements.txt

2. Create and set up environment variables:

cp ./sample_env.txt .env
# Edit .env with your MongoDB URI

4. Connect to database using mongosh

5. Run Application

cd web-app
python3 app.py

6. Run Tests

cd web-app
pytest test_app.py

The application will be available at http://localhost:3000

Features

• Input available ingredients
• Specify health goals and dietary preferences
• Get AI-generated recipes
• View recipe history
• MongoDB integration for recipe storage

Development

• Main branch: Production-ready code
• Development happens in feature branches
• PRs required for merging into main
• CI/CD pipeline runs tests automatically