# Project export: RecruitAI

This document was generated by HackStack to give an AI agent context about a hackathon project. Sections are labeled with their provenance; content marked as truncated was cut to keep this document small.

## Project metadata

- Hackathon: Cal Hacks 12.0
- Tagline: From Resume to Hire, Powered by AI
- Devpost: https://devpost.com/software/recruitai-v40wdi
- GitHub: not linked
- Video: https://www.youtube.com/embed/YQHsXMglC9A?enablejsapi=1&hl=en_US&rel=0&start=&version=3&wmode=transparent
- Team: contributor stats unavailable

## Devpost submission (written by the team)

### Inspiration

The hiring process is broken. Recruiters spend countless hours manually reviewing resumes, struggling to objectively compare candidates, and losing track of where applicants are in the pipeline. We've seen talented candidates slip through the cracks and hiring managers make gut-feel decisions without data to back them up. We wanted to build a solution that brings AI-powered intelligence to recruiting while keeping humans in the driver's seat, automating the tedious parts so recruiters can focus on what matters: connecting with great talent.

### What it does

RecruitAI transforms the entire recruiting funnel with AI-powered automation: Instant Resume Analysis: Paste any resume and get immediate scoring across experience, skills, and education using semantic search and keyword analysis Smart Candidate Scoring: Multi-dimensional evaluation that goes beyond keyword matching to understand context and relevance Pipeline Management: Track candidates through five stages, Resume Review, Phone Screen, Technical Interview, Final Round, and Offer Real-time KPI Dashboard: Visualize hire rates, average scores, pipeline breakdowns, and performance metrics Top 10 Rankings: Instantly identify your best candidates by overall score, experience, or skills Recruiter Analytics: Compare performance across recruiting teams with detailed metrics and charts

### How we built it

Frontend: React with a modern, gradient-themed UI featuring interactive dashboards, modal dialogs, and real-time data visualization using Chart.js Backend: FastAPI (Python) providing RESTful APIs for candidate management, scoring algorithms, and KPI calculations Database: SQLite with SQLAlchemy ORM for rapid development and easy deployment AI Scoring Engine: Custom algorithms combining: Keyword extraction and matching for technical skills Semantic analysis of work experience Education level evaluation Weighted scoring system for overall candidate ranking Keyword extraction and matching for technical skills Semantic analysis of work experience Education level evaluation Weighted scoring system for overall candidate ranking

### Challenges we ran into

Scoring Algorithm Complexity: Building a fair, accurate scoring system that works across different roles and experience levels was harder than expected. We iterated multiple times to balance keyword matching with semantic understanding. UI/UX Balance: Creating an interface that's both beautiful and functional for busy recruiters meant constant iteration on information density and visual hierarchy.

### Accomplishments we're proud of

End-to-End Solution: We built a complete, working product from database to UI in a hackathon timeframe Smart AI Scoring: Our scoring algorithm actually works and provides meaningful differentiation between candidates Beautiful Analytics: The KPI dashboard isn't just functional, it's genuinely pleasant to use with smooth animations and clear data visualization Production-Ready Code: Clean architecture, proper error handling, and a codebase that could actually be deployed Real Problem Solved: This isn't just a demo it solves a genuine pain point that recruiters face every day

### What we learned

AI isn't magic: Building effective scoring algorithms requires domain knowledge, iteration, and validation User experience matters: Even the best backend is useless if recruiters can't quickly understand and act on the insights Start simple, then scale: We initially tried to build too many features, focusing on core functionality first made us more successful Data visualization is hard: Making complex recruiting metrics understandable at a glance required multiple design iterations Full-stack is powerful: Having control over both frontend and backend allowed us to iterate and rapidly optimize the entire user experience

### What's next

Voice AI Integration: Automated interview scheduling with voice cloning for personalized candidate outreach Email Automation: Smart email campaigns that adapt based on candidate stage and engagement Calendar Integration: Seamless interview coordination with automatic scheduling and reminders PDF Resume Upload: Direct file upload with advanced parsing using OCR and NLP ATS Integration: Connect with existing Applicant Tracking Systems

## README (from the GitHub repository)

No README available.

## Detected evidence (automated analysis)

No repository was indexed for this project. Claimed technologies below could not be checked against code.
- FastAPI (technology) — claimed on Devpost, not found in the code
- JavaScript (language) — claimed on Devpost, not found in the code
- Node.js (technology) — claimed on Devpost, not found in the code
- Python (language) — claimed on Devpost, not found in the code
- React (technology) — claimed on Devpost, not found in the code

## Codebase structure

No repository index available.

## Key source files

No repository index available; no source files included.