An open API service indexing awesome lists of open source software.

https://github.com/akash-nath29/recipefinder-flask


https://github.com/akash-nath29/recipefinder-flask

Last synced: 30 days ago
JSON representation

Awesome Lists containing this project

README

        

🍽️ Recipe Finder - Flask 🍲



Forks
Pull Requests
Views
Contributors
License


---

## Table of Contents

- [About the Project](#about-the-project)
- [Built With](#built-with)
- [Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Usage](#usage)
- [Contributing](#contributing)
- [License](#license)
- [Contact](#contact)
- [Acknowledgements](#acknowledgements)

---

## About the Project

![Recipe Finder Screenshot](https://your-image-url.com/screenshot.png)

Recipe Finder is a web application built with Flask that allows users to search for recipes based on ingredients or keywords. It provides a user-friendly interface for discovering new culinary delights.

### Built With

- [Python](https://www.python.org/)
- [Flask](https://flask.palletsprojects.com/)
- [Edamam Recipe Search API](https://developer.edamam.com/)

---

## Getting Started

To get started with Recipe Finder, follow these steps:

### Prerequisites

- Python (version 3.6 or higher)
- Flask (install via `pip install Flask`)

### Installation 🚀

1. Clone the repository
```sh
git clone https://github.com/Akash-nath29/recipeFinder-Flask.git
```
2. Create a virtual environment (optional but recommended)
```sh
python -m venv venv
source venv/bin/activate
```
- for windows
```sh
venv\Scripts\activate
```
3. Install dependencies
```sh
pip install -r requirements.txt
```
4. Run the application
```sh
python app.py
```

---

## Usage ✨

- Enter ingredients or keywords in the search bar. 🍳🥦🍝
- Click the "Search" button. 🔍
- Browse through the search results for delicious recipes. 🍴

---

## Contributing 🤝

Contributions are welcome! If you'd like to contribute to Recipe Finder, please follow these guidelines:
1. Fork the project. 🍴
2. Create your feature branch (`git checkout -b feature/YourFeature`). 🌟
3. Commit your changes (`git commit -m 'Add some feature'`). 💬
4. Push to the branch (`git push origin feature/YourFeature`). 🚀
5. Open a pull request. 🔗

---

## License 📄

Distributed under the MIT License. See [LICENSE](https://github.com/Akash-nath29/recipeFinder-Flask/blob/main/LICENSE) for more information.

---

## Contact 📧

- Akash Nath - [email protected]

Project Link: [https://github.com/Akash-nath29/recipeFinder-Flask](https://github.com/Akash-nath29/recipeFinder-Flask)

---

## Acknowledgements 🙏

- [Edamam Recipe Search API](https://developer.edamam.com/)