Nexus - AI Resume Analyzer & Interview Platform

An AI-powered platform that analyzes resumes, detects skill gaps, recommends jobs, and generates personalized interview strategies using ML + LLMs.

---

Live Demo

🔗 https://resume-analysis-gray-five.vercel.app

---

Features

AI Resume Analysis

• NLP-based resume parsing
• Skill extraction & matching
• Resume-to-job compatibility score
• Missing skills detection

Job Recommendations

• Fetches top matching jobs based on resume
• Direct redirection to job application pages

AI Interview Preparation (LLM Powered)

• Technical questions generation
• Behavioral questions generation
• Personalized interview roadmap

Authentication System

• Email OTP verification
• Secure JWT-based authentication
• Forgot password functionality

Smart Dashboard

• Resume history tracking
• Performance analytics
• Skill improvement insights

Profile System

• Bio, skills, and career goals
• Social links (LeetCode, GitHub, etc.)
• Custom skill addition

Community Chat

• Real-time chat (Socket.io)
• Reactions, replies, media sharing
• Toxicity detection (ML model)

API Key System

• Bring your own Groq API key
• Unlock advanced AI features

---

ML System Highlights

• Built a separate FastAPI microservice for ML inference
• Implemented resume-job matching using TF-IDF and cosine similarity
• Developed spam detection (Naive Bayes) and toxicity detection (Logistic Regression)
• Hosted large ML models externally using Hugging Face for scalable deployment
• Integrated real-time ML inference into a full-stack MERN application

For detailed architecture and implementation, see ML Service Documentation

---

🏗️ Architecture Diagram

graph TD

%% ================= FRONTEND =================
subgraph FRONTEND ["Frontend Layer - React"]
A1[Landing Page]
A2[Authentication Pages]
A3[Dashboard UI]
A4[Profile Management]
A5[Resume Upload UI]
A6[Community Chat UI]
A7[Settings - API Key]
A8[State Management]
A9[Routing]
A10[Socket Client]
end

%% ================= BACKEND =================
subgraph BACKEND ["Backend Layer - Node Express"]
B1[Express Server]
B2[REST API Controllers]
B3[Auth Service]
B4[JWT Middleware]
B5[Resume Service]
B6[Analysis Service]
B7[Job Recommendation Service]
B8[User Profile Service]
B9[Community Chat Service]
B10[Notification Service]
end

%% ================= DATABASE =================
subgraph DATABASE ["Database Layer - MongoDB"]
C1[(MongoDB)]
C2[Users Collection]
C3[Resumes Collection]
C4[Analysis Results]
C5[Jobs Collection]
C6[Chat Messages]
C7[Profile Data]
end

%% ================= ML SERVICE =================
subgraph ML ["ML NLP Service - Python"]
D1[FastAPI Server]
D2[Resume Parser]
D3[Skill Extractor]
D4[Matching Model]
D5[Scoring Engine]
end

%% ================= LLM =================
subgraph LLM ["LLM Layer - Groq"]
E1[Technical Questions]
E2[Behavioral Questions]
E3[Interview Roadmap]
end

%% ================= EXTERNAL =================
subgraph EXTERNAL ["External Services"]
F1[Job APIs]
F2[Email OTP Service]
F3[Cloud Storage]
end

%% ================= FLOW =================

A1 --> A2
A2 --> B1
A5 --> B5
A6 --> B9
A10 --> B9
A7 --> B8

B1 --> B2
B2 --> B3
B3 --> B4

B3 --> F2
B3 --> C2

B5 --> C3
B5 --> D1

D1 --> D2
D2 --> D3
D3 --> D4
D4 --> D5

D5 --> B6
B6 --> C4

B6 --> B7
B7 --> F1
B7 --> C5

B6 --> E1
B6 --> E2
B6 --> E3

B8 --> C2
B8 --> C7
B6 --> C4

B9 --> C6
B9 --> A6

B5 --> F3

%% USER FLOW
U1[User] --> A1
U1 --> A5
U1 --> A3
U1 --> A4
U1 --> A6
U1 --> A7

A3 --> B6
A3 --> B7

E1 --> A3
E2 --> A3
E3 --> A3

Loading

---

Workflow

1. User registers and verifies email via OTP

2. Uploads resume + optional job description

3. ML model analyzes resume:

   • Skill match %
   • Missing skills
   • Career suggestions

4. System fetches job recommendations

5. Optional: Add Groq API key

6. LLM generates:

   • Technical questions
   • Behavioral questions
   • Interview roadmap

7. User tracks progress via dashboard

---

📸 Screenshots

🔐 Authentication

---

🏠 Landing Page (Mobile View)

---

📊 Dashboard

---

💳 My Plan

---

📄 Resume Analysis Result

---

👤 Profile Section

---

💬 Community Chat

---

⚙️ Settings (API Key)

---

🛠️ Admin Dashboard

---

🛠️ Tech Stack

Frontend

• React.js
• Tailwind CSS / SCSS
• Context API / Redux
• Socket.io Client

Backend

• Node.js
• Express.js
• JWT Authentication
• REST APIs

Database

• MongoDB

AI / ML

• Python (FastAPI)
• NLP (Resume parsing & scoring)
• Custom ML Models

LLM Integration

• Groq API

External Services

• Email OTP Service
• Job Scraping APIs
• Cloud Storage

---

API Endpoints

Authentication

Method	Endpoint	Description
POST	/api/auth/register	Register a new user
POST	/api/auth/login	Authenticate user and return token
POST	/api/auth/logout	Logout user
GET	/api/auth/get-me	Get current authenticated user details
POST	/api/auth/forgot-password	Send OTP to user's email
POST	/api/auth/verify-otp	Verify OTP for password reset
POST	/api/auth/reset-password	Reset user password

---

Resume & Analysis

Method	Endpoint	Description
POST	/api/resume/analyze-resume	Analyze resume using NLP model and return match score, missing skills, and suggestions

---

Interview (AI + LLM)

Method	Endpoint	Description
POST	/api/interview	Generate interview report from resume (ML + LLM)
GET	/api/interview	Get all interview reports for user
GET	/api/interview/report/:interviewId	Get specific interview report
POST	/api/interview/resume/pdf/:interviewReportId	Generate downloadable resume PDF

---

Plans / Roadmap

Method	Endpoint	Description
POST	/api/plans	Create a new learning/interview plan
GET	/api/plans	Get all user plans
GET	/api/plans/:planId	Get plan by ID
PATCH	/api/plans/:planId/day/:dayIndex/task/:taskIndex	Toggle task completion
POST	/api/plans/:planId/day/:dayIndex	Add new task
DELETE	/api/plans/:planId/day/:dayIndex/task/:taskIndex	Delete task

---

Profile

Method	Endpoint	Description
POST	/api/profile/create	Create user profile
GET	/api/profile/me	Get current user profile
PUT	/api/profile/update	Update profile details
POST	/api/profile/upload-image	Upload profile image

---

Settings

Method	Endpoint	Description
POST	/api/settings/save-grok-key	Save user's Groq API key

---

File Upload

Method	Endpoint	Description
POST	/api/upload	Upload files (resume, media, etc.)

---

Admin (Protected Routes)

Method	Endpoint	Description
GET	/api/admin/stats	Get platform statistics (admin only)
GET	/api/admin/users	Get all users (admin only)
DELETE	/api/admin/users/:id	Delete a user (admin only)

---

Admin Panel

• Secure admin dashboard access
• View all registered users
• Delete users from the platform
• Monitor platform activity and statistics

---

Installation

1. Clone the repository

git clone https://github.com/your-username/repo-name.git
cd repo-name

2. Install dependencies

npm install

3. Setup environment variables

Create a .env file in the root of your backend:

Backend (.env)

MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret
PORT=3000
ENCRYPTION_KEY=your_32_char_encryption_key

CLOUDINARY_CLOUD_NAME=your_cloudinary_name
CLOUDINARY_API_KEY=your_cloudinary_api_key
CLOUDINARY_API_SECRET=your_cloudinary_api_secret

ML_SERVICE_URL=your_ml_service_url
GOOGLE_GENAI_API_KEY=your_google_api_key
BREVO_API_KEY=your_brevo_api_key

Frontend (.env)

VITE_BACKEND_URL=your_backend_url

4. Run the app

npm run dev

---

Contribution Guide

1. Fork the repository
2. Create a new branch

git checkout -b feature-name

3. Make changes
4. Commit

git commit -m "Added new feature"

5. Push

git push origin feature-name

6. Open Pull Request

⭐ Support

If you like this project, please ⭐ the repo!

---

Author

Akash Santra

---

Additional Information

• Contribution Guidelines: CONTRIBUTING.md
• Security Policy: SECURITY.md
• Code of Conduct: CODE_OF_CONDUCT.md

---