Adaptive Scholarship Matching + AI Drafting
A next-generation scholarship assistance platform that not only matches students to opportunities, but also helps them apply intelligently through adaptive, AI-guided essay generation and analysis.
ScholarLens uses AI to learn the hidden "personality" of scholarships and generates tailored application essays aligned to those personalities. It's designed to help students write differentiated, personalized essays for multiple scholarships.
- Persona Builder: Extracts scholarship personality genome (weights + tone) from descriptions
- Essay Generator: Creates personalized essays matching scholarship personas
- Evaluation Agent: Compares adaptive vs generic essays with alignment metrics
- Mirror Test: Provides improvement suggestions for existing essays
- Cluster Labeler: Learns personality patterns from winner essays
- React + TypeScript
- Zustand (state management)
- Vite (build tool)
- Recharts (visualization)
- FastAPI (Python)
- PostgreSQL
- Anthropic Claude API
- Node.js ≥ 18.x
- Python ≥ 3.11
- PostgreSQL ≥ 14
- Anthropic Claude API Key
- Clone the repository:
git clone git@github.com:Bruce1508/ScholarLens.git
cd ScholarLens- Set up environment variables:
cp .env.example .env
# Update CLAUDE_API_KEY and DATABASE_URL in .env- Install backend dependencies:
cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt- Install frontend dependencies:
cd frontend
npm ci- Run the application:
# Backend (from backend/)
uvicorn main:app --reload
# Frontend (from frontend/)
npm run dev- PROJECT_OVERVIEW.md - Project overview and architecture
- DEVELOPEMENT.md - Development setup and guidelines
- .claude/CLAUDE.md - Claude Code configuration
This project is part of the Agentiiv Hackathon Team — AI Innovation Track.
MIT License - open for educational use and academic collaboration.
Owner: Nguyen Duc Anh Vo (Bruce Vo)
Team: Agentiiv Hackathon Team — AI Innovation Track
Tagline: "We don't just help students apply. We help them resonate."