Skip to content

An-abandoned-bun/UniPath-AI-Assistence.

Repository files navigation

UniPath AI Planner

Live Demo: https://diddypath-a3709.web.app

UniPath AI Planner is an AI-powered university application planning website built for Bangladeshi and international students. The platform helps students shortlist universities based on their academic profile, English test score, SAT score, intended major, country preference, budget, scholarship need, and extracurricular strength.

The goal of this project is to make university application planning more structured, personalized, and accessible for students who want to study abroad.


Built By

  • Syed Aban Safwan
  • Nehan Nubaid

Both contributors worked on the idea, planning, implementation, testing, data improvement, and development of UniPath AI Planner.


Project Overview

Many international students struggle to decide where to apply because university requirements, costs, scholarships, country preferences, and admission chances are difficult to compare manually.

UniPath AI Planner solves this by allowing students to enter their profile and receive a ranked university shortlist with:

  • Safe / Target / Reach classification
  • Country-based filtering
  • Scholarship chance ranking
  • Budget-based matching
  • Major-based matching
  • Application timeline
  • Improvement suggestions
  • AI-powered explanation through Groq API

Features

Student Profile Form

Users can enter:

  • Academic strength
  • English test score
  • SAT score
  • Intended major
  • Preferred countries
  • Annual budget
  • Scholarship need
  • Extracurricular strength
  • Visa risk preference

University Matching System

The app ranks universities using multiple factors:

Category Points
Academic Match 40
English Test Match 15
Budget Match 20
Major Fit 15
Scholarship Fit 10

The final result is classified as:

Score Classification
80–100 Safe / Strong Match
60–79 Target
40–59 Reach
Below 40 High Reach

Country Filter

Students can select preferred countries, and the results will only show universities from those selected countries.

This helps users focus on realistic application destinations based on their goals, budget, and country preference.


Scholarship Chance Ranking

The app prioritizes universities that are more suitable for students who need scholarships.

It considers:

  • Scholarship friendliness
  • Estimated tuition
  • Country cost level
  • Academic strength
  • Major fit
  • User budget
  • Scholarship need

AI Advisor

UniPath AI Planner includes an AI advisor powered by Groq API through a secure Cloudflare Worker.

The AI advisor can:

  • Explain why a university is Safe, Target, Reach, or High Reach
  • Suggest the best universities for the student’s profile
  • Recommend the strongest scholarship options
  • Give improvement suggestions
  • Explain country and budget tradeoffs
  • Help students understand their application strategy

The Groq API key is not exposed in the frontend or GitHub repository. It is stored securely inside Cloudflare Worker secrets.


University Database

The app includes a growing university database with information such as:

  • University name
  • Country
  • Website
  • Estimated tuition
  • Living cost estimate
  • English requirement estimate
  • SAT recommendation
  • Major strengths
  • Scholarship friendliness
  • Scholarship chance
  • Visa risk
  • Deadline notes

The project also includes plans for adding more data from sources such as Wikidata, Wikipedia summaries, and other public university information sources.


Tech Stack

Frontend

  • HTML
  • CSS
  • JavaScript

Hosting

  • Firebase Hosting

Database / Data Storage

  • Static university dataset
  • Firestore-ready structure for future saved plans and dynamic data

AI Backend

  • Cloudflare Worker
  • Groq API

Deployment

  • Firebase Hosting for the website
  • Cloudflare Worker for AI requests

Project Structure

unipath-ai-planner
├── public/
│   ├── index.html
│   ├── app.js
│   ├── styles.css
│   ├── firebase-config.js
│   └── data/
│       └── universities.js
│
├── cloudflare-worker/
│   ├── worker.js
│   └── wrangler.toml
│
├── docs/
│   ├── DEMO.md
│   ├── TESTING_REPORT.md
│   ├── AI_DEBUGGING_NOTES.md
│   └── GITHUB_UPLOAD_GUIDE.md
│
├── screenshots/
│   └── README.md
│
├── firebase.json
├── firestore.rules
├── .gitignore
└── README.md

How to Use the Website

  1. Open the live demo: https://diddypath-a3709.web.app
  2. Fill in your student profile.
  3. Select your preferred countries.
  4. Enter your intended major.
  5. Add your budget and scholarship need.
  6. Generate your university plan.
  7. Review Safe, Target, Reach, and High Reach universities.
  8. Ask the AI advisor for explanation or scholarship-focused recommendations.

Example AI questions:

Which university is the best option for my profile?
Which universities have the highest scholarship chance?
What should I improve before applying?
Which country is most realistic for my budget?

Security

This project does not expose private API keys in the frontend.

The Groq API key is stored inside Cloudflare Worker secrets.

Do not upload the following to GitHub:

.env
.dev.vars
Groq API key
Firebase private service account keys
Cloudflare secret values

Firebase web config may be public, but private API keys and service credentials should never be uploaded.


Future Roadmap

Planned improvements:

  • Add full Firestore university database
  • Add user login
  • Save student profiles
  • Save university shortlists
  • Add admin dashboard for university data entry
  • Add deadline tracker
  • Add scholarship tracker
  • Add country-wise visa checklist
  • Add essay checklist
  • Add document checklist
  • Add more verified university data
  • Add Wikidata/Wikipedia importer
  • Add AI-powered ranking refinement
  • Add PDF export for application plans
  • Add dashboard analytics for students

Why This Project Matters

University application planning is often confusing for international students because there are many factors to compare at the same time: academics, budget, scholarships, country, visa risk, major availability, and deadlines.

UniPath AI Planner makes this process easier by turning student information into a structured application plan.

This project combines web development, AI integration, data-based ranking, and real-world education planning into one useful platform.


Disclaimer

UniPath AI Planner is an educational planning tool. It does not guarantee admission, scholarships, or visa approval.

Students should always verify final admission requirements, tuition fees, scholarship deadlines, and visa rules from official university and government websites before applying.

Releases

No releases published

Packages

 
 
 

Contributors