ResumeAI Architect 🚀

An AI-powered resume builder and optimizer designed to help job seekers crack the Applicant Tracking System (ATS) code.

ResumeAI Architect is a modern web application that leverages Generative AI to analyze, score, and rewrite resumes in real-time. It ensures resumes are not just visually appealing but also optimized for ATS algorithms and tailored to specific job descriptions.

---

🚩 Problem Statement

In today's competitive job market, valid candidates often get rejected before a human ever sees their application. This happens because:

1. ATS Rejection: Resumes lack specific keywords or formatting required by Applicant Tracking Systems.
2. Weak Impact: Bullet points often detail "responsibilities" rather than measurable "achievements."
3. Skill Gaps: Candidates fail to explicitly mention skills that match the job description, even if they possess them.
4. Time Consumption: Tailoring a resume for every single job application is tedious and time-consuming.

💡 Solution

ResumeAI Architect bridges the gap between candidates and recruiters by providing an intelligent suite of tools:

• Real-time ATS Scoring: Instantly calculates an ATS score based on impact, keywords, and structure.
• Resume Heatmap: Visually identifies strong vs. weak bullet points using color-coded feedback.
• Skill Gap Analysis: Extracts keywords from job descriptions and compares them against the resume to highlight missing skills.
• AI-Powered Rewrite: Uses the XYZ Formula ("Accomplished [X] as measured by [Y], by doing [Z]") to rewrite weak bullet points and naturally incorporate missing keywords.
• Live Preview & PDF Export: See changes in real-time and download a perfectly formatted, ATS-friendly PDF.

---

🛠️ Tech Stack

Frontend

• Framework: React 19 (Vite)
• Language: TypeScript
• Styling: Tailwind CSS
• Icons: Lucide React

Backend

• Runtime: Node.js & Express
• AI Model: Llama 3.3 70b via Groq API
• Vector Store: Custom Local Vector Store (for keyword similarity)
• PDF Parsing: pdf-parse

---

🚀 Features

1. Smart Resume Builder

• Drag-and-drop section reordering.
• Support for custom sections (Volunteering, Awards, etc.).
• "Auto-Fill" with sample data for quick testing.

2. Resume Heatmap

• Green: Strong bullet (Contains metrics & action verbs).
• Yellow: Medium bullet (Good but could be stronger).
• Red: Weak bullet (Vague or too long).

3. Job Fit Analysis

• Past a job description to see a Match Score.
• View a list of Matched Skills vs. Missing Skills.

4. One-Click Optimization

• Context-aware AI rewriting that fills skill gaps.
• "Before vs. After" toggle to compare changes.
• Instant application of AI suggestions to your resume.

---

📦 Setup Instructions

Follow these steps to run the project locally.

Prerequisites

• Node.js (v16 or higher)
• npm or yarn
• A Groq API Key (component of the backend)

1. Clone the Repository

git clone https://github.com/N0AHZACH/hackathon-team-HAK08.git
cd hackathon-team-HAK08

2. Setup Backend

cd backend
npm install

• Create a .env file in the backend folder:

  GROQ_API_KEY=your_groq_api_key_here
  PORT=3001

• Start the server:

  npm start

  Server runs on http://localhost:3001

3. Setup Frontend

Open a new terminal window:

cd ..  # Return to root directory
npm install
npm run dev

• Frontend runs on http://localhost:3000

---

👥 Team Members

Name	Role
Noahan Zachariah	Full Stack Developer
Shaniya Varghese	Frontend Developer / UI
Ryan George	Backend Developer / AI

---

📄 License

This project is open-source and available under the MIT License.