avantifellows/college-predictor

A tool to enable students in India to get an idea of which college they will get into based on their rank and the exam, and also give a searchable list of scholarships that they may be eligible for.

Avanti-College Predictor

Avanti provides high-school students free test preparation programs, mentorship and career services that help them place into top-tier Science and Technology colleges across India. Our students more than double their household income on graduating and escape the cycle of intergenerational poverty.

Project Overview

The College Predictor application helps students find:

1. A list of colleges with opening and closing ranks based on:
   • Exam
   • Category
   • Category rank
   • Round Number
   • Gender
   • Home State
2. A list of applicable scholarships based on:
   • Scholarhship Status
   • Grade
   • Stream
   • Category
   • Family Annual Income
   • Gender
   • Home State
   • City Name

Getting Started

Prerequisites

1. Node.js (version 14 or above)
2. npm (comes with Node.js)

Installation

1. Fork the college-predictor repository.
2. Clone the forked repository to your local computer (replacing the values in {{}}):

   git clone https://github.com/{{YOUR_GITHUB_USERNAME}}/college-predictor.git
   cd college-predictor

3. Install dependencies

   npm install

4. Run the local development server at http://localhost:3000

   npm run start