README.md

---
title: Resume-Analyzer
emoji: 📄
colorFrom: blue
colorTo: purple
sdk: streamlit
sdk_version: 1.28.0
app_file: src/app.py
pinned: false
license: mit
---

# 🚀 AI-Powered Resume Analyzer

A comprehensive resume analysis tool built with Streamlit that provides detailed insights, ATS scoring, and actionable feedback for job seekers.

## ✨ Features

### Core Functionality
- **Multi-format Support**: Upload PDF, DOCX, or TXT resumes
- **Smart Text Extraction**: Advanced parsing for different file types
- **Section Identification**: Automatically detects Education, Experience, Skills, etc.
- **ATS Scoring**: Comprehensive analysis of ATS-friendliness
- **Role-based Matching**: Keyword matching for specific job roles

### Advanced Analysis
- **Skill Extraction**: Identifies technical and soft skills
- **Grammar Check**: Built-in language quality assessment
- **Keyword Optimization**: Fuzzy matching for role-specific terms
- **Visual Analytics**: Word clouds, charts, and interactive dashboards

### Unique Features
- **AI Persona Summary**: Generates LinkedIn-style professional summaries
- **Interactive Dashboard**: Multiple analysis tabs with rich visualizations
- **Downloadable Reports**: Comprehensive PDF reports with actionable insights
- **Real-time Feedback**: Instant suggestions for improvement

## 🎯 Supported Job Roles

- Data Scientist
- Software Engineer
- Product Manager
- Marketing Manager
- Data Analyst

## 🚀 How to Use

1. **Select Job Role**: Choose your target position from the sidebar
2. **Upload Resume**: Support for PDF, DOCX, and TXT formats
3. **Get Analysis**: Comprehensive scoring and feedback across 5 categories:
   - 📊 Overview & AI Summary
   - 🎯 Skills Analysis & Job Matching
   - 📝 Section Breakdown
   - 🔍 ATS Compatibility
   - 📋 Detailed Report & Suggestions

## 📊 Analysis Features

### 1. Resume Overview
- Basic statistics (word count, sections)
- AI-generated persona summary
- Word cloud visualization

### 2. Skills Analysis
- Technical skills detection
- Soft skills identification
- Job role matching with percentage scores
- Skills gap analysis

### 3. Section Breakdown
- Automatic section parsing
- Content preview for each section
- Missing section identification

### 4. ATS Analysis
- Comprehensive ATS scoring (0-100)
- Grammar and language quality check
- Improvement recommendations
- Visual score dashboard

### 5. Report Generation
- Overall performance metrics
- Detailed strengths and weaknesses
- Actionable improvement suggestions
- Downloadable analysis reports

## 🔧 Technical Stack

### Libraries Used
- **Streamlit**: Web interface and deployment
- **PyPDF2/pdfplumber**: PDF text extraction
- **python-docx**: DOCX file processing
- **NLTK**: Natural language processing
- **spaCy**: Advanced NLP and entity recognition
- **fuzzywuzzy**: Fuzzy string matching
- **language-tool-python**: Grammar checking
- **scikit-learn**: Machine learning utilities
- **plotly/matplotlib**: Data visualization

## 📈 Scoring Methodology

### ATS Score (0-100)
- **Section Completeness** (40%): Presence of key sections
- **Text Length** (20%): Optimal word count range
- **Contact Information** (20%): Email and phone detection
- **Format Structure** (20%): Bullet points and formatting

### Role Match Score (0-100%)
- Keyword presence analysis
- Fuzzy matching for variations
- Industry-specific term recognition
- Skills alignment assessment

## 🎨 Key Features

### Interactive UI
- **Responsive Design**: Works on desktop and mobile
- **Interactive Tabs**: Organized analysis sections
- **Progress Indicators**: Visual feedback during processing
- **Color-coded Metrics**: Intuitive score visualization
- **Badge System**: Clean skill and keyword display

### Smart Analysis
- **AI-Powered Summaries**: Professional persona generation
- **Contextual Feedback**: Role-specific recommendations
- **Visual Analytics**: Charts, graphs, and word clouds
- **Export Functionality**: Download comprehensive reports

## 🔍 Usage Tips

### For Best Results
- Upload high-quality, text-based files (avoid scanned images)
- Ensure your resume includes standard sections
- Use the role selector to get targeted keyword analysis
- Review all analysis tabs for comprehensive insights

### Optimization Recommendations
- Include relevant keywords naturally in context
- Use standard section headings (Experience, Education, Skills)
- Add quantifiable achievements with numbers
- Balance technical and soft skills
- Keep formatting clean and ATS-friendly

## 🔐 Privacy & Security

- **No Data Storage**: Resume content is processed in memory only
- **Local Processing**: All analysis happens on the server without external API calls
- **Secure Handling**: Files are processed securely and not retained
- **Privacy First**: Your resume data remains confidential

## 🤝 Perfect For

- **Job Seekers**: Optimize resumes for specific roles
- **Career Counselors**: Provide data-driven feedback
- **Students**: Improve academic and entry-level resumes
- **Professionals**: Enhance career transition materials
- **Recruiters**: Quick candidate assessment tool

## 🚀 Get Started

Simply upload your resume above and select your target job role to receive comprehensive analysis and actionable insights!

---

**Made with ❤️ for job seekers worldwide**

*Help us improve by providing feedback and suggestions!*