arya2004 / arya2004/beginner-python-mini-projects-hacktoberfest-2025

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

Open
#81 0 comments 0 reactions 1 assignee Claimed by @sameera731 View on GitHub
Dominant language
Jupyter Notebook
Stars
25
Forks
113
PR merge metrics
No merged PRs in 30d

Description

**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!

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.