How prembarot/globalpath-ai works
GlobalPath AI helps students and professionals explore study, work, visa, and settlement options. The main journey is account or guest entry, profile-based country and university recommendations, then admission estimates; separate views cover jobs, scholarships, visas, citizenship, live data, and saved reports. Streamlit is the primary documented interface, with a FastAPI/web interface reusing the same engine. The README documents live-provider enrichment and CSV fallback; some page and router implementations were not sampled, so those branches are represented at their supported module paths.
Main entry points: __init__.py Feature pages · data_loader.py Dataset access · main.py REST API · study_abroad.py Study planning
Components 28
User interfaces
- Streamlit entry
app.py - Feature pages
views/__init__.py - REST API
api/main.py - Web client
frontend/static/app.js - Chat page
views/chatbot_view.py
Planning and guidance
- Study planning
views/study_abroad.py - Career planning
views/jobs.py - Scholarships
views/scholarships.py - Visa and settlement
core/visa.py - Dashboard and live data
views/dashboard.py
Data services
- Dataset access
core/data_loader.py - Rule recommenders
core/recommendation.py - Live providers
core/providers/__init__.py - HTTP and cache
core/providers/http.py - Bundled CSV data
- External live data
ML and chatbot
- ML prediction
ml/predictor.py - Prediction explanations
ml/explain.py - Dataset retrieval
chatbot/rag.py - RAG chatbot
chatbot/chatbot.py
Accounts and saved data
- Sign-in page
views/auth_view.py - Account authentication
auth/auth.py - SQLite accounts and saves
db/database.py - Saved recommendations and reports
views/saved.py - PDF export
utils/pdf_report.py - API authentication
api/routers/auth.py - Saved API
api/routers/saved.py
Other components
- Student or professional
Connections 34
- Student or professional → Streamlit entry: opens app
- Streamlit entry → Sign-in page: shows auth gate
app.py - Streamlit entry → Feature pages: routes pages
app.py - Feature pages → Study planning: includes
- Feature pages → Career planning: includes
- Feature pages → Scholarships: includes
- Feature pages → Dashboard and live data: includes
- Feature pages → Chat page: includes
- Sign-in page → Account authentication: uses
views/auth_view.py - Account authentication → SQLite accounts and saves: reads and writes
auth/auth.py - Study planning → Rule recommenders: requests matches
views/study_abroad.py - Career planning → Rule recommenders: requests matches
views/jobs.py - Study planning → ML prediction: estimates admission
views/study_abroad.py - Career planning → ML prediction: predicts salary and sponsorship
views/jobs.py - Career planning → Prediction explanations: requests explanations
views/jobs.py - Study planning → Prediction explanations: requests explanations
views/study_abroad.py - Prediction explanations → ML prediction: loads model
ml/explain.py - Rule recommenders → Dataset access: loads datasets
core/recommendation.py - Dataset access → Live providers: enriches datasets
core/data_loader.py - Dataset access → Bundled CSV data: loads fallback
- Live providers → HTTP and cache: fetches with cache
- HTTP and cache → External live data: requests live data
- Dashboard and live data → Dataset access: loads metrics and live data
views/dashboard.py - Chat page → RAG chatbot: submits questions
- RAG chatbot → Dataset retrieval: retrieves context
chatbot/chatbot.py - Dataset retrieval → Dataset access: indexes datasets
chatbot/rag.py - Student or professional → REST API: uses API
- REST API → API authentication: registers router
api/main.py - REST API → Saved API: registers router
api/main.py - REST API → Dataset access: serves shared data
api/main.py - API authentication → Account authentication: delegates authentication
api/routers/auth.py - Saved API → SQLite accounts and saves: reads and writes
api/routers/saved.py - Saved recommendations and reports → SQLite accounts and saves: loads and deletes saves
views/saved.py - Saved recommendations and reports → PDF export: exports report
views/saved.py