Certainly! Here's a README file for the IIT-PREDICTOR project on GitHub:
IIT-PREDICTOR is a web application that predicts the chances of admission into Indian Institutes of Technology (IITs) based on JEE Advanced scores. It aims to assist students in understanding their likelihood of getting admitted to the prestigious IITs and helps them make informed decisions about their academic future.
- Predicts admission chances: The application predict the chances of admission into IITs based on JEE Main and Advanced scores.
- Multiple IIT predictions: Users can get predictions for various IITs and courses to explore different options.
- User-friendly interface: The web application provides an intuitive and user-friendly interface for inputting scores and viewing predictions.
- Data visualization: The application provides graphical representations of data to help users understand the prediction results effectively.
- Responsive design: The user interface is designed to work seamlessly on different devices and screen sizes.
We would like to thank the following contributors for their valuable contributions to IIT-PREDICTOR:
- Alexander(@alexravi)
- Sravya Vardhini(@SravyaVardhani)
- Likitha (@Suppu2004)
- Shinjini (@shinjini72)
- Gayatri(@Gayathri1073)
- Vallabh(@Sri-Vallabh)
Contributions are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request.
Before contributing, please review the contribution guidelines.
Follow these steps to set up IIT-PREDICTOR locally:
- Python 3.x: Install the latest Python 3 version from the official Python website: Python Downloads
- Pip: The Python package installer. It is usually bundled with Python. You can check if it's installed by running
pip --version
in the terminal.
-
Clone the repository:
git clone https://github.com/alexravi/IIT-PREDICTOR.git
-
Change to the project directory:
cd IIT-PREDICTOR
-
Create a virtual environment:
python3 -m venv venv
-
Activate the virtual environment:
-
For Windows:
venv\Scripts\activate
-
For macOS and Linux:
source venv/bin/activate
-
-
Install the dependencies:
pip install -r requirements.txt
-
Run the application:
python app.py
-
Access the application:
Open a web browser and go to
http://localhost:8000
to access the IIT-PREDICTOR application locally.
- Input your JEE Advanced scores into the provided fields.
- Select the desired IIT and course for prediction.
- Click the "Predict" button to view the chances of admission.
![Screenshot 2023-07-03 at 2 35 33 PM](https://private-user-images.githubusercontent.com/69623604/250511554-7f99afbf-7e9d-4ce9-b9ea-13c972f12454.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjQ5ODUwNTEsIm5iZiI6MTcyNDk4NDc1MSwicGF0aCI6Ii82OTYyMzYwNC8yNTA1MTE1NTQtN2Y5OWFmYmYtN2U5ZC00Y2U5LWI5ZWEtMTNjOTcyZjEyNDU0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA4MzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwODMwVDAyMjU1MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTRiODA1ODE3MDBkNjY3ZTFhNzlkOWE1NGFjYzY3OWIwZjMyNDI1YjI4NWRkOWE1ZTA1ZmNmZDgzZTU0MWZkODMmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.j71WQe5iFvX22WnIlOOLqvXRnhhlmxl9iC38KmPH8qo)
![Screenshot 2023-07-03 at 2 36 04 PM](https://private-user-images.githubusercontent.com/69623604/250511547-47387392-fe91-40e3-b03f-2dbedd7c925a.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjQ5ODUwNTEsIm5iZiI6MTcyNDk4NDc1MSwicGF0aCI6Ii82OTYyMzYwNC8yNTA1MTE1NDctNDczODczOTItZmU5MS00MGUzLWIwM2YtMmRiZWRkN2M5MjVhLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA4MzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwODMwVDAyMjU1MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTFiZDMwM2RkMTI1YTE5YmYzM2YwOWM1MGE2MDMwOGQ3OGNiMDhkMDMyZmY3Y2JlYzlkZDhkZDlhZjgxZmFiYzUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.C67nPrf2SiBd9Py2uAZG_C27NyHpq7Xjv5x7nHfnyMc)
![Screenshot 2023-07-03 at 2 36 12 PM](https://private-user-images.githubusercontent.com/69623604/250511540-a9a1e70a-2076-4bc5-85f6-58da92c998b9.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjQ5ODUwNTEsIm5iZiI6MTcyNDk4NDc1MSwicGF0aCI6Ii82OTYyMzYwNC8yNTA1MTE1NDAtYTlhMWU3MGEtMjA3Ni00YmM1LTg1ZjYtNThkYTkyYzk5OGI5LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA4MzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwODMwVDAyMjU1MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTJjOWZlODhlNjkzNWYyZjdjZGYzZjkwYzY0YWJhNTJhNWY1ZWI0MjZiZjZlNDBjMmJjOGI0ZjE5MTVhYjA0YmEmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.w4vFa1mCUJ34owocv7WS6LHRq5scMtc5kTIdaz_iNyY)
![Screenshot 2023-07-03 at 2 36 19 PM](https://private-user-images.githubusercontent.com/69623604/250511517-76210cab-92af-46ff-90ab-113057a8560e.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjQ5ODUwNTEsIm5iZiI6MTcyNDk4NDc1MSwicGF0aCI6Ii82OTYyMzYwNC8yNTA1MTE1MTctNzYyMTBjYWItOTJhZi00NmZmLTkwYWItMTEzMDU3YTg1NjBlLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA4MzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwODMwVDAyMjU1MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTcyYTZhZGEyZGI3MTU1MWI5ZWU1NzdhZGE5MDUyOTVhYjhhODFmYmVlN2I2YjRmZWI5YTU4Y2MxMGJhMWUwNjMmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.lc62xrAIPkc_JPchOw3xyrxgTFK1bx9Rh8R7YFXiW98)
IIT-PREDICTOR is released under the MIT License.
IIT-PREDICTOR was created by Alex Ravi as a personal project and is provided as an open-source application for others to use and learn from. The project utilizes various open-source libraries and tools, to which the author expresses gratitude.
Special thanks to the Python and Flask communities for their valuable contributions and support.