About ResumeAI

Understanding how the resume analysis engine works.

📄 What is ResumeAI?

ResumeAI is an AI-powered resume parser that uses rule-based analysis to extract structured information from plain-text resumes. It identifies skills, calculates ATS compatibility scores, detects experience levels, and matches resumes against job postings -- all without external API calls.

🛠 How It Works

1. Section Extraction

Regex-based detection of resume sections: Contact, Summary, Experience, Education, Skills, Certifications, and more.

2. Skill Extraction

Keyword matching against a database of 150+ skills across 6 categories: Programming, Frameworks, Databases, Cloud, Data, and Soft Skills.

3. ATS Scoring

Compatibility score (0-100) based on contact completeness, skill count, skill diversity, education, experience, and formatting quality including action verb usage.

4. Job Matching

Compares extracted skills against job requirements to calculate a match percentage, identify gaps, and provide recommendations.

🎯 ATS Scoring Breakdown

Criterion Max Points Description
Email Present 10 Professional email address detected
Phone Present 10 Phone number detected
Skills Listed 20 Number of recognized technical skills
Skill Diversity 15 Skills across multiple categories
Education 15 Degree level detected (higher = more points)
Experience 15 Years of experience mentioned
Formatting 15 Name, sections, action verbs, resume length
Total 100

💻 Technology Stack

Backend Flask 3.0 (Python)
Database SQLite + SQLAlchemy
Validation Pydantic 2.5
Testing pytest + coverage
Container Docker + Compose
CI/CD GitHub Actions

🚀 API Endpoints

Method Endpoint Description
GET/api/healthHealth check
POST/api/parseParse resume text
POST/api/ats-scoreGet ATS score only
POST/api/matchMatch against a job
POST/api/match-allMatch against all jobs
GET/api/resumesList parsed resumes
GET/api/resumes/:idGet specific resume
GET/api/jobsList job postings
GET/api/sampleGet sample resume
GET/api/skills/categoriesSkill categories