Skip to content

Commit

Permalink
Create README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Dheerajjha451 authored Mar 25, 2024
1 parent 48e93a3 commit 732e4b7
Showing 1 changed file with 87 additions and 0 deletions.
87 changes: 87 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
<div align="center">

# Meet_Your_Pet
</div>

![Python](https://img.shields.io/badge/python-v3.10%2B-blue)
![React](https://img.shields.io/badge/react-v18.2.66-blue)
![GitHub last commit](https://img.shields.io/github/last-commit/Dheerajjha451/Meet_Your_Pet?logo=github)
![GitHub Repo stars](https://img.shields.io/github/stars/Dheerajjha451/Meet_Your_Pet?style=social)
![GitHub forks](https://img.shields.io/github/forks/Dheerajjha451/Meet_Your_Pet?style=social)

## About
Meet Your Pet is a `web application` powered by `machine learning` algorithms that predict the breed of a dog based on uploaded images. Whether you're curious about the any breed dog or want to identify the breed of a new rescue, Meet Your Pet offers a convenient and accurate solution.

# Running Meet Your Pet

**Meet Your Pet** consists of two main components: the backend and the frontend. The backend handles the machine learning algorithms and prediction logic, while the frontend provides the user interface for interacting with the system.

## Running the Backend

### Setup

1. Navigate to the `Backend` directory:

```
cd Meet_Your_Pet/Backend
```

2. Install the required Python packages:

```
pip install -r requirements.txt
```

### Starting the Server

3. Run the backend server:

```
python app.py
```

The backend server should now be running and ready to handle requests.

## Running the Frontend

### Setup

1. Navigate to the `frontend` directory:

```
cd Meet_Your_Pet/frontend
```

2. Install the required Node.js packages:

```
npm install
```

### Starting the Development Server

3. Start the development server for the frontend:

```
npm run dev
```
# Screenshots
![Desktop](https://github.com/Dheerajjha451/Meet_Your_Pet/assets/106474979/22c4a889-88ec-409f-bd99-6c1e260ff141)
![Desktop1](https://github.com/Dheerajjha451/Meet_Your_Pet/assets/106474979/528605fe-cabc-4a4e-a705-108d2d307496)
![Desktop2](https://github.com/Dheerajjha451/Meet_Your_Pet/assets/106474979/5a6fa828-cc75-427b-b545-9b6b30a69a06)


## Project Goal
The Meet Your Pet project is started with the aim to match dogs with their best caretakers, bridging the gap between pets at different adoption centers and people seeking different breeds of dogs. By allowing users to upload images of dogs, the system predicts the breed of the dog and provides a short description. If the dog is available at any adoption center, the platform also offers information about the adoption center to potential dog owners. Through this process, Meet Your Pet strives to facilitate meaningful connections between dogs in need of homes and individuals eager to provide them with care and companionship.

## Current Status and Future Plans

At present, the Meet Your Pet project is equipped to predict the breed of a dog based on uploaded images and provide a short description of the breed. However, our journey doesn't end here. We are committed to enhancing the platform to facilitate connections between adoption centers and individuals seeking dogs. In the near future, we plan to implement features that will enable users to view adoption center information for dogs they are interested in. Through these enhancements, we aim to make the adoption process seamless and efficient, ensuring that every dog finds a loving and caring home. Stay tuned for updates as we work towards this goal!

---
# Contributing
Check out the [contributing guidelines](https://github.com/Dheerajjha451/Meet_Your_Pet/blob/main/CONTRIBUTING.md)

# License
This project is licensed under the [License.](https://github.com/Dheerajjha451/Meet_Your_Pet/blob/main/LICENSE)

0 comments on commit 732e4b7

Please sign in to comment.