Skip to content

Commit d39e6f3

Browse files
committed
updated README file
1 parent bbed15c commit d39e6f3

1 file changed

Lines changed: 85 additions & 2 deletions

File tree

README.md

Lines changed: 85 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,85 @@
1-
![alt text](image.png) keys
2-
LIVE at: http://a4d76dacd85884eaaa2c0f1b1e173b67-1601615365.us-east-1.elb.amazonaws.com
1+
# Hotel Reservation Prediction
2+
3+
![Python](https://img.shields.io/badge/Python-3.9-blue?logo=python&logoColor=white)
4+
![Flask](https://img.shields.io/badge/Flask-2.0.3-green?logo=flask&logoColor=white)
5+
![Docker](https://img.shields.io/badge/Docker-Containerization-blue?logo=docker&logoColor=white)
6+
![AWS](https://img.shields.io/badge/AWS-Cloud-orange?logo=amazon-aws&logoColor=white)
7+
![Jenkins](https://img.shields.io/badge/Jenkins-CI%2FCD-red?logo=jenkins&logoColor=white)
8+
![LightGBM](https://img.shields.io/badge/LightGBM-Model-green?logo=lightgbm&logoColor=white)
9+
10+
## Overview
11+
This project demonstrates an end-to-end MLOps pipeline for predicting hotel reservations. It includes data ingestion, preprocessing, model training, and deployment. The application is deployed on AWS using EKS and Load Balancer, and it features a Flask-based web interface for user interaction.
12+
13+
## Features
14+
- **MLOps Pipeline**: Automates machine learning workflows.
15+
- **Flask Web Application**: User-friendly interface for predictions.
16+
- **AWS Deployment**: Hosted on AWS using EKS and Load Balancer.
17+
- **Dockerized Application**: Fully containerized for portability.
18+
- **CI/CD Pipeline**: Seamless integration and deployment with Jenkins and GitHub Actions.
19+
- **LightGBM Model**: Efficient and accurate predictions.
20+
21+
## Technologies Used
22+
- **Python**: Core programming language.
23+
- **Flask**: Web framework for the application.
24+
- **Docker**: Containerization for consistent environments.
25+
- **AWS**: Cloud platform for deployment.
26+
- **Jenkins**: CI/CD pipeline for automation.
27+
- **GitHub Actions**: For continuous integration and deployment.
28+
- **LightGBM**: Machine learning model for predictions.
29+
30+
## Getting Started
31+
32+
### Prerequisites
33+
- Python 3.9+
34+
- Docker
35+
- AWS CLI
36+
- kubectl
37+
- Jenkins (optional for CI/CD)
38+
39+
### Installation
40+
1. Clone the repository:
41+
```bash
42+
git clone https://github.com/your-repo/hotel-reservation-prediction.git
43+
cd hotel-reservation-prediction
44+
```
45+
46+
2. Install dependencies:
47+
```bash
48+
pip install -r requirements.txt
49+
```
50+
51+
3. Build the Docker image:
52+
```bash
53+
docker build -t flask-app .
54+
```
55+
56+
4. Run the Docker container:
57+
```bash
58+
docker run -p 5000:5000 flask-app
59+
```
60+
61+
5. Access the application:
62+
Open your browser and navigate to `http://localhost:5000`.
63+
64+
### Deployment on AWS
65+
1. Push the Docker image to Amazon ECR.
66+
2. Deploy the application to an EKS cluster.
67+
3. Access the application via the Load Balancer URL.
68+
69+
## Deployment Process
70+
- **DinD Deployment**: Used Docker-in-Docker for building and testing the application.
71+
- **GitHub Actions**: Automated CI/CD pipeline for testing and deployment.
72+
- **EKS AWS Deployment**: Deployed the Docker image to an AWS EKS cluster for scalability and reliability.
73+
74+
## Contributing
75+
We welcome contributions! To contribute:
76+
1. Fork the repository.
77+
2. Create a new branch for your feature or bug fix.
78+
3. Commit your changes and push the branch.
79+
4. Open a pull request.
80+
81+
## Live Application
82+
**Try before I am out of AWS credits**: [Hotel Reservation Prediction](http://a4d76dacd85884eaaa2c0f1b1e173b67-1601615365.us-east-1.elb.amazonaws.com)
83+
84+
## License
85+
This project is licensed under the MIT License.

0 commit comments

Comments
 (0)