Skip to content

An interactive Streamlit web application that helps students discover relevant scholarships worldwide using Google Gemini AI. The app analyzes your academic profile and preferences to recommend scholarships, provide personalized analysis, and allow easy export of results.

Notifications You must be signed in to change notification settings

orbimatrix/scholar_agent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎓 AI Scholarship Finder Agent

An interactive Streamlit web application that helps students discover relevant scholarships worldwide using Google Gemini AI. The app analyzes your academic profile and preferences to recommend scholarships, provide personalized analysis, and allow easy export of results.


🚀 Features

  • AI-powered scholarship search: Uses Gemini AI to suggest scholarships based on your profile.
  • Personalized analysis: Get tailored recommendations and tips to improve your chances.
  • Modern UI: Clean, responsive interface with summary stats and color-coded scholarship cards.
  • Export options: Download results as CSV or a summary report.
  • Fallback data: If AI is unavailable, fallback scholarships for major countries are provided.

🛠️ Setup Instructions

1. Clone the repository

git clone https://gitlab.com/saqib99/scholarship_agent
cd scholarship_agent

2. Create and activate a virtual environment (optional but recommended)

python -m venv venv
# On Windows:
venv\Scripts\activate
# On Mac/Linux:
source venv/bin/activate

3. Install dependencies

pip install -r requirements.txt

4. Get a Google Gemini API Key

5. Run the application

streamlit run main.py

📝 Usage

  1. Enter your Gemini API key in the sidebar.
  2. Fill in your academic and scholarship preferences.
  3. Click Find Scholarships.
  4. Browse the results, personalized analysis, and export options.

⚠️ Data Source & Limitations

  • AI-generated data: Scholarship results are generated by Gemini AI and may not always be up-to-date or accurate. Always verify details with official sources.
  • Fallback data: If the AI fails, a small set of hardcoded scholarships is shown.
  • No real-time scraping/API: The app does not currently fetch live data from external APIs or websites.

📄 Requirements

  • Python 3.8+
  • See requirements.txt for all dependencies

🤖 Powered by


📬 Feedback & Contributions

Pull requests and suggestions are welcome!


📢 Disclaimer

Scholarship information is AI-generated and should be verified with official sources. The authors are not responsible for any inaccuracies or missed opportunities.

About

An interactive Streamlit web application that helps students discover relevant scholarships worldwide using Google Gemini AI. The app analyzes your academic profile and preferences to recommend scholarships, provide personalized analysis, and allow easy export of results.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages