search

avantifellows / college-predictor

Given rank and category, we display a list of suitable colleges for exams such as JEE Main, JEE Advanced, NEET. Data avaialble.
GNU General Public License v3.0
5 stars 19 forks source link

readme

![Avanti fellow logo](https://i.imgur.com/t0MrYMI.png)

Avanti-College Predictor

**[Avanti](https://www.avantifellows.org/) 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

  3. Fork the college-predictor repository.
  4. 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
  5. Install dependencies 
    npm install
  6. Run the local development server at http://localhost:3000 
    npm run start