Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

107 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Best View in Dark Mode (Recommended)


Buy me cofee

🏝️ Smart AI Resume Analyzer 🏝️

Your Intelligent Career Partner
Smart Resume AI

Your AI-powered resume assistant for career success

Smart Resume AI is a full-stack, AI-driven platform that helps users analyze, build, optimize, and track resumes, while also matching them with real-time job opportunities and ATS-based insights..

Built with by Surinder



🧠 How Smart Resume AI Works (High-Level)

  1. User uploads or builds a resume

  2. Resume is parsed into structured data

  3. AI + ATS logic analyzes skills, keywords, and structure

  4. Real-time feedback and scores are generated

  5. Resume performance is tracked on analytics dashboard

  6. Jobs are scraped and matched based on skills

What Makes Us Different?

Next-Level Features for Success:

  1. πŸ•΅οΈ Deep Resume Analysis:

    • πŸ›‘οΈ ATS Compatibility Score
    • πŸ”‘ Keyword Gap Analysis
    • 🧩 Role-specific Feedback
    • πŸ“Š Skills Gap Breakdown
  2. 🎨 AI-Powered Resume Builder:

    • Themes that Shine (Modern, Minimal, Professional, Creative)
    • Smart Content Suggestions
    • ATS-Optimized Formatting
    • Customizable Sections
  3. πŸ€– AI Optimization Engine:

    • πŸ’‘ Keyword Highlighting
    • ✍️ Content Enhancement Tips
    • 🌟 Industry-Specific Insights

**πŸŽ‰ Why Use Smart Resume AI?**

Get real-time feedback, boost your resume's impact, and maximize your chances of getting shortlistedβ€”all with a sleek and intuitive interface.

Live Demo

πŸ‘¨β€πŸ’» Try it Now: Open in Streamlit

Tech Stack

🌐 Frontend
🌟 Technology πŸ’Ό Role
Streamlit Builds interactive and user-friendly web apps for resume analysis.
HTML Provides the basic structure for web pages.
CSS Adds styling and layouts to the frontend.
JavaScript Enables interactivity and dynamic behavior for the web pages.
βš™οΈ Backend
🌟 Technology πŸ’Ό Role
Streamlit Handles backend logic and integrates machine learning models.
Python Provides core programming language for implementing functionalities.
πŸ—„οΈ Database
🌟 Technology πŸ’Ό Role
SQLite3 Stores and retrieves resume data for efficient processing.
πŸ“¦ Modules
🌟 Technology πŸ’Ό Role
spaCy Enhances NLP for keyword analysis and ATS compatibility checks.
Python-docx Enables Word document editing for resume customization.
PyPDF2 Processes PDF files for extracting and analyzing resumes.
scikit-learn Drives machine learning models for resume optimization.
Plotly Creates interactive charts for skills gap and keyword analysis.
NLTK Provides tools for tokenization, stemming, and text preprocessing in NLP.
openpyxl Facilitates reading, writing, and modifying Excel files for data visualization and export.

πŸ’‘ How It Works

  1. Upload or Start from Scratch

    • Import your resume in PDF/Word or create one from scratch with our AI-powered builder.
  2. Analyze Your Resume

    • ATS Compatibility: Ensure your resume meets recruiter expectations.
    • Keyword Insights: Find and fill gaps in your content.
    • Skills Gap Analysis: Discover key skills missing for your target role.
  3. Build a Stunning Resume

    • Select from 4 unique templates and customize sections like skills, achievements, or hobbies.
  4. Download & Apply

    • Export your resume in PDF format, ready for submission. This project has evolved with significant enhancements to its resume analysis capabilities:

Follow these steps to run Smart Resume AI:

Setup Instructions πŸ› οΈ

Follow the steps below to set up and run the Smart AI Resume Analyzer on your local machine.

  1. Clone the repository:

Open a terminal and run:

https://github.com/SurinderTech/Resume-analyzer-ai.git
cd Smart-AI-Resume-Analyzer
  1. Create a Virtual Environment(Optional)

Set up a virtual environment to manage dependencies:

python -m venv venv

Activate the Virtual Environment:

  • Windows:
    venv\Scripts\activate
  • MacOS & Linux:
    source venv/bin/activate
  1. Install dependencies:

Install the required Python packages:

pip install -r requirements.txt
  1. Download the spaCy model:

Ensure that the necessary NLP model is installed:

python -m spacy download en_core_web_sm

Congratulations πŸ₯³πŸ˜± your set-up πŸ‘† and installation is finished πŸ₯³πŸ˜±

  1. Configure Environment Variables (Mandatory for AI-Analyzer Functionality):

To enable access to the Gemini API used by the AI Resume Analyzer, you need to set up environment variables securely.

βœ… Step-by-Step:

  1. Create a .env file inside the utils/ directory.
  2. Paste your Google Gemini API key in the following format:

πŸ“„ Example content for utils/.env:

GOOGLE_API_KEY=your_google_gemini_api_key

Google LOGO Get your Gemini API Key:

Visit Google AI Studio – Gemini API Access πŸ‘‰ Grab and use your own API key β€” Since Mine One Have Usage Limits.

  1. Run the application:

Start the application using Streamlit:

streamlit run app.py
πŸ“ Folder Structure After Adding .env

πŸ” Important:

  • Do not commit your .env file to version control (e.g., GitHub). It should be listed in .gitignore.
  • If you're collaborating, you can provide a safe .env.example file with dummy data.
πŸ—‚οΈ Folder Structure Preview 1 πŸ—‚οΈ Folder Structure Preview 2
Folder Structure Preview 1 Folder Structure Preview 2

Admin Login Credentials

πŸ”Ή New Login Credentials:

  • Username:
admin@example.com
  • Password:
admin123

πŸ”Ή Admin Panel Access:

  • The Admin Section will be visible only after login, right below the Dashboard section.

Known Bug 🚨 Autofill Glitch in Resume Builder!

What's Happening? πŸ€”

If you're using the Browser's (e.g., Chrome, Edge, etc.) Autofill feature to quickly fill out your Name, Email, and Phone details in our Smart AI Resume Analyzer, you might encounter this error in generating Resume:
"⚠️ Please enter your email address."

Even though the email field appears to be filled, this is a small bug in the Resume Builder Feature where our system doesn't always recognize inputs from autofill.

Quick Fix πŸ› οΈ

Don't worryβ€”it's a simple fix!

  1. Edit the email(or Any) field manually:
    • Remove one character or number.
    • Type it back in.
  2. VoilΓ ! The error will disappear, and you can generate your resume smoothly.

(β€œVoilà” means "there you have it!" or "problem solved!")

Why Does This Happen? 🌐

This is a known issue with the resume builder feature, where the autofill behavior of browsers (e.g., Chrome, Edge, etc.) doesn't trigger the necessary validation for some input fields. By manually editing the email, the system recognizes it correctly.

We're actively working on a permanent fix to ensure your experience is seamless. Thank you for your understanding and support! πŸ™

🎯 Why Choose Smart Resume AI?*

✨ Tailored for You
Your resume is optimized for the job you're aiming for, using role-specific insights.

πŸ–ΌοΈ Stunning Templates
Choose from polished and modern templates that stand out at first glance.

⚑ Time-Saving Automation
AI does the heavy lifting, helping you create a winning resume in minutes.

πŸ“ˆ Better Chances, Every Time
Get actionable feedback and align your resume to job descriptions effortlessly.

Contributing

Join the mission! Here's how:

  1. Fork the repository.
  2. Create a new branch for your feature: git checkout -b feature-name.
  3. Push changes and submit a Pull Request.

Why Users Love Smart Resume AI

  • Saves Time: Create a stunning resume in minutes.
  • Increases Job Opportunities: Tailor your resume to any role.
  • Professional Output: Choose from modern and polished designs.
  • Boosts Confidence: Optimized, recruiter-ready resumes.

Features That Set Us Apart

Feature Description
πŸ” Resume Analysis Get an ATS score, identify keyword gaps, and find skills to add for role alignment.
✨ Customizable Templates Choose from 4 sleek designs: Modern, Minimal, Professional, Creative.
πŸ“ˆ AI-Driven Insights Receive smart suggestions for optimizing content, formatting, and keywords.
🎯 Role-specific Guidance Tailored recommendations for matching job descriptions and standing out in applications.

πŸŽ₯ Quick Glance

πŸŽ₯ Quick Glance – Version 2.0 (AI-Powered Resume Analyzer)

Note: Time Taking For scraping so have Patience

🎨 Interactive Resume Templates

                 |  

πŸ“„ License

This project is licensed under the MIT License.

πŸ”— Helpful Links

  • Streamlit Badge

  • Documentation Badge

  • AI Models Badge

🌟 GitHub Repo

Explore the code, contribute, or drop a Star: https://github.com/SurinderTech/Resume-analyzer-ai

πŸ›‘οΈ Maintainer

This repository is maintained by Surinder.
Have suggestions? Feel free to reach out to me via email. πŸ“§

πŸ“° News

Practice, practice, practice! Keep working hard, and it will all fall into place. No shortcuts in this Field! πŸ› οΈ

Stay curious and keep learning. πŸš€

                             |

Thank you for your support! Every bit helps keep this repository going. 🌈✨

Resume-analyzer-ai

About

Smart Resume AI represents my vision of democratizing career advancement through technology. By combining cutting-edge AI with intuitive design, this platform empowers job seekers at every career stage to showcase their true potential and stand out in today's competitive job market.

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Sponsor this project

Packages

Contributors

Languages