README.md

metadata

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!