https://github.com/malu2003/resume-screener
🎯 AI-powered resume analysis tool with smart chatbot. Built with Angular & NestJS using Gemini AI. Get match scores, optimization tips & career advice. 🚀
https://github.com/malu2003/resume-screener
angular chatbot gemini-ai nestjs resume-analyzer resume-tips
Last synced: about 2 months ago
JSON representation
🎯 AI-powered resume analysis tool with smart chatbot. Built with Angular & NestJS using Gemini AI. Get match scores, optimization tips & career advice. 🚀
- Host: GitHub
- URL: https://github.com/malu2003/resume-screener
- Owner: Malu2003
- Created: 2025-06-19T05:48:25.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-19T06:04:35.000Z (about 1 year ago)
- Last Synced: 2025-06-19T07:19:19.625Z (about 1 year ago)
- Topics: angular, chatbot, gemini-ai, nestjs, resume-analyzer, resume-tips
- Language: TypeScript
- Homepage:
- Size: 236 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🎯 Resume Screening Tool with AI Chatbot
**A powerful, AI-driven resume analysis tool that helps job seekers optimize their resumes for better job matches.**
Built with Angular, NestJS, and Google's Gemini AI.
---
## 🎭 **How It Works - Application Flow**
```mermaid
graph TD
A[👤 User uploads Resume] --> B[📄 File Processing]
B --> C[🔍 Text Extraction]
C --> D[🤖 AI Analysis via Gemini]
D --> E[📊 Generate Match Score]
E --> F[📈 Create Detailed Report]
F --> G[💬 AI Chatbot Ready]
G --> H{User Interaction}
H -->|Ask Questions| I[🧠 Contextual AI Response]
H -->|New Analysis| A
I --> J[💡 Personalized Advice]
J --> H
style A fill:#e1f5fe
style D fill:#f3e5f5
style G fill:#e8f5e8
style I fill:#fff3e0
```
## 🏗️ **System Architecture**
```mermaid
graph LR
subgraph "Frontend (Angular)"
A[Resume Upload Form]
B[Results Dashboard]
C[AI Chatbot Interface]
end
subgraph "Backend (NestJS)"
D[Resume Controller]
E[AI Service]
F[File Parser Utility]
end
subgraph "External Services"
G[Google Gemini AI]
end
A --> D
B --> D
C --> D
D --> E
D --> F
E --> G
style A fill:#e3f2fd
style B fill:#e8f5e8
style C fill:#fff3e0
style E fill:#f3e5f5
style G fill:#ffebee
```
## 🔄 **Data Flow Diagram**
```mermaid
sequenceDiagram
participant U as 👤 User
participant F as 🖥️ Frontend
participant B as ⚙️ Backend
participant AI as 🤖 Gemini AI
U->>F: Upload Resume + Job Description
F->>B: POST /api/resume/match-resume
B->>B: Extract text from file
B->>AI: Send resume text + job description
AI->>B: Return analysis results
B->>F: Formatted analysis response
F->>U: Display results + Enable chatbot
Note over U,AI: Chatbot Interaction Flow
U->>F: Ask question via chatbot
F->>B: POST /api/resume/chat
B->>AI: Generate contextual response
AI->>B: Personalized advice
B->>F: Chatbot response
F->>U: Display AI advice
```
---
---
## 📸 **Application Screenshots**
### 🎯 **Complete User Journey**
#### **🏠 Landing Page - Resume Analysis Hub**
Clean, professional interface with clear call-to-action for resume analysis
---
#### **📄 Upload Interface - File Selection & Job Description**
Form for uploading resume files and pasting job descriptions
#### **📊 Analysis Results - Comprehensive Sentiment Dashboard**
Detailed analysis with match score, strengths, weaknesses, and keyword analysis
---
#### **💪 Strengths & Improvements - Detailed Feedback**
---
#### **💪 Recommendations - Detailed Feedback**
---
#### **💬 AI Chatbot Interface - Interactive Q&A**
Conversational AI interface for asking specific questions about resume analysis
---
## ✨ **Features Showcase**
### 🔍 **Smart Resume Analysis**
- 🎯 **AI-Powered Matching**: Uses Google Gemini AI for intelligent resume-job matching
- 📊 **Match Score Calculation**: Get a precise compatibility score (0-100%)
- 🔑 **Keyword Analysis**: Identifies matched and missing keywords
- 💪 **Strengths & Improvements**: Detailed feedback on resume strengths and areas for improvement
### 💬 **Interactive AI Chatbot**
- 🎯 **Personalized Advice**: Ask specific questions about your resume analysis
- ⚡ **Real-time Responses**: Get instant, contextual career advice
- ❓ **Follow-up Questions**: Smart suggestions for deeper insights
- 🚀 **Resume Optimization Tips**: Actionable recommendations for improvement
### 📊 **Comprehensive Analytics**
- 🎨 **Visual Match Score**: Color-coded scoring system
- 📈 **Detailed Breakdown**: Technical skills, experience, and qualifications analysis
- 🏆 **Priority Recommendations**: High/Medium/Low priority improvement suggestions
- 💼 **Professional Insights**: Industry-standard resume optimization advice
### 🎨 **Modern UI/UX**
- 📱 **Responsive Design**: Works perfectly on desktop and mobile
- 🖥️ **Intuitive Interface**: Clean, user-friendly design
- ⏱️ **Real-time Loading**: Smooth animations and progress indicators
- ♿ **Accessibility**: WCAG compliant design
---
## 🚀 **Quick Start Guide**
### 📋 **Prerequisites**
```bash
✅ Node.js (v18+ recommended)
✅ npm or yarn
✅ Google Gemini API Key
```
### 1️⃣ **Clone the Repository**
```bash
git clone https://github.com/Malu2003/resume-screening.git
cd resume-screening-tool
```
### 2️⃣ **Backend Setup**
```bash
cd backend
npm install
# Create environment file
echo "GEMINI_API_KEY=your_gemini_api_key_here" > .env
echo "PORT=3000" >> .env
```
### 3️⃣ **Frontend Setup**
```bash
cd ../frontend
npm install
```
### 4️⃣ **Start the Application**
```bash
# Terminal 1: Start Backend
cd backend && npm run start:dev
# Terminal 2: Start Frontend
cd frontend && ng serve
```
### 5️⃣ **Open Your Browser**
Navigate to **http://localhost:4200** 🎉
---
## 🛠️ **Technology Stack**
| **Frontend** | **Backend** | **AI & APIs** |
|:---:|:---:|:---:|
|  |  |  |
|  |  |  |
|  |  |  |
---
## 📁 **Project Structure**
```
🏗️ resume-screening-tool/
├── 🖥️ frontend/ # Angular Application
│ ├── 📂 src/
│ │ ├── 📂 app/
│ │ │ ├── 📂 components/
│ │ │ │ ├── 📄 resume-form/ # File Upload Component
│ │ │ │ ├── 📊 results/ # Analysis Results Display
│ │ │ │ └── 💬 chatbot/ # AI Chatbot Interface
│ │ │ ├── 🔧 services/ # Angular Services
│ │ │ └── 📝 models/ # TypeScript Interfaces
│ │ └── 🎨 assets/ # Static Assets
│ └── 📦 package.json
├── ⚙️ backend/ # NestJS Application
│ ├── 📂 src/
│ │ ├── 📂 resume/ # Resume Analysis Module
│ │ │ ├── 🎮 resume.controller.ts
│ │ │ ├── 🔧 resume.service.ts
│ │ │ └── 📦 resume.module.ts
│ │ ├── 🤖 services/
│ │ │ └── 🧠 ai.service.ts # Gemini AI Integration
│ │ └── 🛠️ utils/
│ │ └── 📄 file-parser.util.ts # File Processing Utilities
│ └── 📦 package.json
├── 📖 README.md
├── 🚫 .gitignore
└── 📄 LICENSE
```
---
## 🎮 **Usage Examples & Screenshots**
### 1️⃣ **Upload Resume**
```
📄 Select your resume file (PDF, DOC, DOCX)
📝 Paste the job description
🚀 Click "Analyze Resume"
⏳ Wait for AI analysis (typically 10-15 seconds)
```
### 2️⃣ **View Results**
```
📊 Get detailed match score and visual analytics
💪 Review strengths and improvement areas
🔍 Check keyword analysis and gap identification
📈 See priority-ranked recommendations
```
### 3️⃣ **Chat with AI**
```
💬 Click "Ask Questions" button
❓ Ask specific questions like:
• "Why did I get this match score?"
• "How can I improve my technical skills section?"
• "What should I focus on first?"
• "Can you explain the missing keywords?"
```
---
## 🔐 **Environment Setup**
Create `.env` file in backend directory:
```env
# 🔑 Required - Get from Google AI Studio
GEMINI_API_KEY=your_gemini_api_key_here
# ⚙️ Optional Configuration
PORT=3000
NODE_ENV=development
MAX_FILE_SIZE=10485760 # 10MB in bytes
ALLOWED_FILE_TYPES=pdf,doc,docx
CORS_ORIGIN=http://localhost:4200
# 📊 Rate Limiting (Optional)
RATE_LIMIT_WINDOW=15 # minutes
RATE_LIMIT_MAX=100 # requests per window
```
---
### **Development Workflow**
```bash
# 1️⃣ Fork the repository
git clone https://github.com/YOUR_USERNAME/resume-screening.git
# 2️⃣ Create feature branch
git checkout -b feature/amazing-feature
# 3️⃣ Make your changes
# ... code changes ...
# 4️⃣ Commit changes
git commit -m '✨ Add amazing feature'
# 5️⃣ Push to branch
git push origin feature/amazing-feature
# 6️⃣ Open Pull Request
```
### **Code Style Guidelines**
- 🎯 Use TypeScript for type safety
- 📝 Follow Angular/NestJS conventions
- 🧪 Write tests for new features
- 📖 Update documentation
- 🚀 Ensure responsive design
---
## 🙏 **Acknowledgments**
**Special thanks to the amazing open-source community and tools that make this project possible:**
| **🤖 AI & ML** | **🛠️ Frameworks** | **☁️ Services** |
|:---:|:---:|:---:|
| [Google Gemini AI](https://ai.google.dev) | [Angular](https://angular.io) | [GitHub](https://github.com) |
| Machine Learning Community | [NestJS](https://nestjs.com) | [npm](https://npmjs.com) |
| Open Source AI Models | [TypeScript](https://typescriptlang.org) | [Node.js](https://nodejs.org) |
**Response Time:** Usually within 24 hours ⚡
---
## 🌟 **Show Your Support**