README.md

metadata

title: Standalone Resume & Job Matcher
emoji: 🚀
colorFrom: purple
colorTo: indigo
sdk: gradio
sdk_version: 4.31.0
app_file: app.py
pinned: false
license: mit

🚀 Standalone Resume & Job Matcher

This Space hosts a powerful, zero-dependency tool for comprehensive resume analysis and job description matching. It's designed to help both job seekers optimize their applications and recruiters quickly assess candidate suitability. The entire application runs from a single Python file with no external dependencies, making it incredibly fast and easy to use.

✨ Key Features

• 🎯 Smart Role Prediction: Paste a resume and the AI will predict the most suitable job role from a database of over 20 distinct positions, complete with a confidence score.
• 📊 Detailed Skill Gap Analysis: Identifies which required skills are present and which are missing for a predicted role, helping you pinpoint areas for improvement.
• 📋 Resume vs. Job Description Matching: Get a detailed compatibility score by comparing a resume directly against any job description.
• 💡 Actionable Career Roadmap: Receive personalized, actionable advice with a short-term (1-3 months) and long-term (1-2 years) career development plan.
• 💰 Salary & Experience Insights: The internal database includes typical salary ranges and experience levels for each job role.
• ⚙️ Zero Dependencies: The entire logic for parsing, scoring, and analysis is self-contained. No API keys or external libraries (beyond Gradio) are needed.

---

🧐 How to Use

The application is split into two main tabs for different use cases.

1. Profile Analysis

This tab is perfect for getting a deep understanding of a candidate's profile or your own resume.

1. Navigate to the "🎯 Profile Analysis" tab.
2. Paste the full text of a resume or professional profile into the input box.
3. Click the "🔍 Analyze Profile" button.
4. Explore the results in the output tabs:
   • Role Classification: See the top 5 predicted roles with match scores.
   • Skill Gap Analysis: View matching skills, missing skills, and learning recommendations.
   • Career Roadmap: Get a visual guide for your next career steps.

2. Profile vs. Job Description Matching

This tab is ideal for checking how well a resume fits a specific job opening.

1. Navigate to the "📋 Profile vs. Job Description" tab.
2. Paste the candidate's resume text in the left box.
3. Paste the target job description in the right box.
4. Click the "🔍 Analyze Match Score" button.
5. Review the outputs:
   • Match Score & Analysis: A JSON output with the overall score and breakdown.
   • Detailed Breakdown: A color-coded visual report showing the match level, matching vs. missing skills, and key recommendations.

---

🛠️ How It Works

This tool uses a multi-faceted approach to analyze text without relying on large language models or external APIs:

1. Text Parsing: A rule-based parser segments the resume into logical sections like Education, Experience, and Skills.
2. Skill Extraction: The text is scanned against a comprehensive internal database of over 200 technical, business, and soft skills.
3. Scoring Algorithm: Role matching is determined by a weighted score combining three factors:
   • Skill Match Score (40%): The percentage of required skills found in the profile.
   • Keyword Score (30%): The frequency of role-specific keywords (e.g., "M&A", "agile", "SEO") in the text.
   • Text Similarity Score (30%): A TF-IDF-inspired cosine similarity calculation between the profile text and the role's description.

---

🚀 How to Deploy Your Own

You can easily run this application in your own Hugging Face Space.

1. Create a Space: Click the "Create new Space" button on Hugging Face.
2. Configure: Give it a name, select "Gradio" as the SDK, and choose a free CPU resource.
3. Add Files:
   • Create a file named app.py and paste the Python code into it.
   • (Optional) Create a requirements.txt file and add one line: gradio.
   • (Optional) Create this README.md file to give your space a professional look.

That's it! The Space will build and launch your application automatically.