arya2004 / arya2004/beginner-python-mini-projects-hacktoberfest-2025
[ADD NEW PROJECT]-Recipe Rover: A Recipe Recommender
- 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
Assessment
This issue has not been assessed yet.