[ADD NEW PROJECT]-Recipe Rover: A Recipe Recommender

[sameera731]

Find what you can cook with what's already in your kitchen! Meet the community of taste buds.

Proposed Project:

A simple web application that allows users to manage a personal recipe book. Users can add their own recipes, view all saved recipes, and, most importantly, find recipes they can make based on the ingredients they currently have at home.

Key Features

1. View All Recipes: A home page that lists all recipes currently in the database.

2. Detailed Recipe View: Clicking a recipe shows its ingredients, instructions and a YouTube link if one was provided.

3. Ingredient Based Search: A search page where users can list their available ingredients, and the app will return a list of recipes they can make, sorted by the best match.

4. Add New Recipes: A user-friendly web form to add a new recipe, including its name, instructions, ingredients (with quantities), and an optional YouTube link.

5. Automatic Database Seeding: The application automatically creates the SQLite database and adds a few sample recipes on its first run, so it's ready for testing immediately.

6. No Authentication: The project is kept simple and does not require any login or user accounts, making it easy for anyone to run and test locally.

Tech Stack

-Backend: FastAPI
-Database: SQLite (python built in sqlite3)
-Frontend: Jinja2 for templating, HTML, CSS.

How to Run:

1. Navigate to the project directory:
   cd path/to/recipe_project/

2. Install dependencies
   pip install fastapi "uvicorn[standard]" jinja2 python-multipart:

3. Start the development server:
   uvicorn main:app --reload

4. Open your browser to http://127.0.0.1:8000 to view the webapp :)

Project Admin: @arya2004
I would love to work on the project and contribute to this repository. Please review this proposal and assign this issue to me as a part of my HACKTOBERFEST 2025 contributions.
Thank You!