Project Info
ElevatR - AI-Powered Career Development Platform
A Chrome extension that helps students track job skills from descriptions and get personalized project recommendations to enhance their resumes.
Features
- Job Description Scraping: Automatically extracts information from job postings
- Skill Tracking: Identifies and categorizes technical and soft skills from job descriptions
- Resume Analysis: Compares your resume against job requirements to identify skill gaps
- Project Recommendations: Suggests personalized projects to build missing skills
- Skills Dashboard: Visualizes skill frequency across saved jobs
Architecture
This project consists of two main components:
- Chrome Extension: Frontend interface for saving job descriptions and viewing analysis
- CrewAI Backend: Multi-agent system that processes job descriptions, analyzes resumes, and recommends projects
AI Agents
The backend uses CrewAI to implement three specialized AI agents:
- Job Description Analyzer: Extracts skills and requirements from job descriptions
- Resume Analyzer: Identifies skills in resumes and compares to job requirements
- Project Recommender: Suggests personalized projects based on skill gaps
Setup
Chrome Extension
- Clone this repository
- Open Chrome and navigate to
chrome://extensions/ - Enable "Developer mode" (toggle in the top-right)
- Click "Load unpacked" and select the repository folder
- The extension should appear in your toolbar
Backend
- Navigate to the backend directory:
cd backend
- Install the required Python packages:
pip install -r requirements.txt
-
Set up your environment variables:
- Copy the
.env.examplefile to.env - Add your Gemini API key to the
.envfile
- Copy the
-
Run the API server:
python run_api.py
The API will be available at http://localhost:8000.
Usage
- Browse job listings on sites like LinkedIn, Indeed, or Glassdoor
- Click the ElevatR extension icon and select "Save Job Description"
- The extension will extract skills and save the job information
- Click "View Dashboard" to see your saved jobs and skill analysis
- Upload your resume to identify skill gaps
- Get personalized project recommendations based on your skill gaps
Technologies Used
- Frontend: HTML, CSS, JavaScript, Chart.js
- Backend: Python, FastAPI, CrewAI, LangChain
- AI:
- Google Gemini API (primary for chat and resume analysis)
- Vectara (for interview question generation and document search)
- Storage: Chrome Extension Storage API
Project Structure
/images- Extension icons/backend- CrewAI backend service/agents- AI agent definitions/api- FastAPI server
- Root files - Chrome extension files (manifest.json, popup.html, etc.)
CruzHacks Submission
This project was created for CruzHacks, focusing on helping students improve their job prospects by identifying and addressing skill gaps through targeted project work.
License
MIT
Analysis
View
Metric
- 9
Figures cover GitHub contributors during the hackathon window. A co-authored commit counts in full for each author, so per-member totals add up to more than the whole-team figures.
Technology
- CrewAIIn code
- CSSIn code
- FastAPIIn code
- HTMLIn code
- JavaScriptIn code
- LangChainIn code
- OpenAIIn code
- PythonIn code
- Google GeminiClaimed
8 of 9 appear in the indexed code. 1 claimed on Devpost could not be matched to code, which may simply mean the tool leaves no trace in the repository.
AI coding agents
No AI coding agent signals were found in this repository.
Detected from committed agent config files and commit authorship. Absence of a signal is not proof an agent was unused.
Codebase size
Source size
442 KB
Source files
32
Counts recognized source files only; vendored directories, binaries and lockfiles are excluded, so this is smaller than the repository on disk.
Repository
osheengupta/CruzHacks-ElevatR
43 files · 550 KB · @ 2d8ed00
Structure
Interface
11 files · 26%Screens, components and styles rendered to the user.
API & routing
1 file · 2%Request entry points: routes, handlers and controllers.
Application logic
23 files · 53%Domain rules, services and shared utilities.
Supporting
Layers are inferred from where files sit in the tree, not from reading the code. A project that names its directories unconventionally will read oddly here — open the file browser to check anything the diagram implies.
Languages
- JavaScript59%
- Python25%
- HTML11%
- CSS5%
- Markdown1%
Share of indexed source by file size. Binary and vendored files are excluded.
Dependencies
backend/requirements.txt
pypi · 7- crewai
- fastapi
- langchain
- openai
- pydantic
- python-dotenv
- uvicorn
Declared in the repository’s manifests at the indexed commit. A declared package is not proof it is used, and runtime dependencies are listed first.
This project’s features have not been analysed yet.
Export this project's context (description, README, evidence, key source files) to chat with an AI agent elsewhere.