🏔️ PelitaScholar: Intelligence Scholarship Community Platform with AI Integration

PelitaScholar is a state-of-the-art scholarship preparation platform powered by Artificial Intelligence. It helps candidates (Seekers) reach international standards through professional feedback, real-world interview simulations, and data-driven scholarship matching.

---

✨ Key Features

✍️ AI Essay Analyzer Pro

Revolutionize your scholarship essays with iterative feedback and precision scoring.

• Paragraph-Level Deep Dive: Instant feedback on clarity, impact, and tone for every paragraph.
• Dimensional Scoring: Track progress across Vision, Evidence, Relevance, and Writing Quality.
• Progression Analytics: Compare revisions to see exactly how your changes impact your score.
• Immutable History: Track your growth over time with a secure, view-only archive of all your iterations.

🌎 Scholarship Matchmaker

Stop searching blindly. Find the best international opportunities tailored to your profile.

• Global Database: Scans international scholarships based on your academic profile.
• Compatibility Engine: Get a percentage match based on IPK, IELTS/TOEFL, and experience.
• Actionable Insights: AI identifies gaps in your profile and suggests strategic improvements.

🎙️ Mock Interview Simulator

Practice with an AI panel that knows exactly what scholarship committees are looking for.

• Context-Aware Simulations: Tailored questions for LPDP, AAS, Chevening, and more.
• STAR Method Coaching: Built-in guidance for structuring high-impact answers.
• Panel Feedback: Detailed evaluation of substance and delivery.

👨‍🏫 Mentoring Ecosystem

Connect Seekers with experienced Awardees (Mentors).

• Class Management: Mentor-led classes with automated slot tracking.
• Approval Workflow: Integrated seeker-to-mentor application system.

---

🚀 Tech Stack

Layer	Technology
Frontend	React, Tailwind CSS v4 (Glassmorphism), Lucide-React
Backend	Python, FastAPI, Uvicorn
AI Intelligence	Google Gemini Pro (Vertex AI / Google AI SDK)
Data & Auth	Firebase Auth, Cloud Firestore
Visualization	Recharts (Progression Analytics)

---

🛠️ Getting Started

Prerequisites

• Node.js (v18+)
• Python (v3.9+)
• Google Gemini API Key
• Firebase Project

1. Backend Setup

cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

Create a .env file in the backend directory:

GEMINI_API_KEY=your_api_key_here

Run the server:

uvicorn main:app --reload --port 8000

2. Frontend Setup

cd frontend
npm install

Create a .env file in the frontend directory:

VITE_API_URL=http://localhost:8000

Run the development server:

npm run dev

---

📁 Project Structure

sherpaai/
├── backend/            # FastAPI Backend
│   ├── models/         # Pydantic & Prompt Templates
│   ├── services/       # AI & Firebase Logic
│   └── main.py         # Entry point
├── frontend/           # React Frontend
│   ├── src/
│   │   ├── components/ # Shared UI Elements
│   │   ├── pages/      # Core AI Modules
│   │   └── contexts/   # Auth & State
└── README.md

---

🎨 Design Philosophy

PelitaScholar uses a Premium Glassmorphism design language.

• Translucency: Frosted glass effects for a modern SaaS feel.
• Vibrant Gradients: Professional color palettes (Sherpa Blue, Emerald Green, Indigo Purple).
• Micro-animations: Smooth transitions and loading states for a premium user experience.

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---