The Smart ATS (Applicant Tracking System) Analyzer is a comprehensive Streamlit-based web application designed to help job seekers optimize their resumes against specific job descriptions. Powered by Groq's Llama-3.1-8b-instant model, this tool provides detailed, actionable feedback to improve your resume's compatibility with Applicant Tracking Systems and enhance your chances of landing interviews.
Unlike basic keyword matching tools, this analyzer provides professional HR-level insights, personalized recommendations, and a beautiful, user-friendly interface with tabbed navigation for easy consumption of feedback.
- ATS Match Score: Realistic scoring out of 100 based on ATS compatibility
- JD Match Percentage: Precise alignment measurement with job requirements
- Keyword Gap Analysis: Identifies missing critical terms and skills
- Strength Recognition: Highlights existing qualifications that match the role
- Professional HR Perspective: 15+ years of recruiting experience simulation
- Actionable Feedback: Specific, implementable suggestions for improvement
- STAR Method Integration: Guidance on quantifying achievements effectively
- Industry-Specific Recommendations: Tailored advice based on job requirements
- Tabbed Interface: Organized presentation across Overview, Strengths, Improvements, and Recommendations
- Visual Score Display: Animated progress bars and gradient-styled score cards
- Responsive Design: Clean, professional UI with glassmorphism effects
- Export Functionality: Download complete analysis as text file
- Custom Professional Summary: Tailored 3-4 line summary optimized for the specific role
- Formatting Suggestions: Consistency and readability improvements
- Technical Skills Optimization: Strategic placement and presentation of capabilities
This application leverages Groq's Llama-3.1-8b-instant model for several key advantages:
- ⚡ Lightning-Fast Processing: Groq's inference engine provides near-instantaneous responses
- 🎯 High Accuracy: Advanced language understanding for nuanced resume analysis
- 💰 Cost-Effective: Efficient processing without compromising quality
- 🔧 Reliable API: Stable service with excellent uptime for production use
- 📊 Structured Output: Consistent markdown formatting for professional presentation
The model excels at understanding context, providing constructive criticism, and generating human-like professional advice that rivals experienced HR consultants.
graph TD
A[🌟 User Lands on Smart ATS Analyzer] --> B[📝 User Pastes Job Description]
B --> C[📎 User Uploads PDF Resume]
C --> D{✅ Input Validation}
D -->|❌ Missing Info| E[⚠️ Show Warning Message]
E --> B
D -->|✅ Valid Inputs| F[📄 Extract Text from PDF using PyPDF2]
F --> G{📖 Text Extraction Success?}
G -->|❌ Failed| H[🚨 Display Error Message]
G -->|✅ Success| I[🔧 Construct Detailed Analysis Prompt]
I --> J[🤖 Send Request to Groq API]
J --> K{🌐 API Response Status}
K -->|❌ Error| L[💥 Show API Error]
K -->|✅ Success| M[📊 Parse Response with Regex]
M --> N[🎨 Apply Custom CSS Styling]
N --> O[📑 Create Tabbed Interface]
O --> P[📈 Display Overview Tab - Scores & Progress]
P --> Q[💪 Display Strengths Tab]
Q --> R[⚠️ Display Improvements Tab]
R --> S[💡 Display Recommendations Tab]
S --> T[💾 Provide Download Option]
T --> U[🔄 Ready for New Analysis]
style A fill:#e1f5fe
style D fill:#fff3e0
style G fill:#fff3e0
style K fill:#fff3e0
style P fill:#e8f5e8
style Q fill:#e8f5e8
style R fill:#fff3e0
style S fill:#e3f2fd
graph LR
subgraph "Frontend Layer"
A[Streamlit UI]
B[Custom CSS Styling]
C[Tabbed Navigation]
end
subgraph "Processing Layer"
D[PDF Text Extraction]
E[Input Validation]
F[Prompt Engineering]
end
subgraph "AI Layer"
G[Groq API Client]
H[Llama-3.1-8b-instant]
I[Response Processing]
end
subgraph "Output Layer"
J[Regex Parsing]
K[Content Formatting]
L[File Export]
end
A --> D
D --> E
E --> F
F --> G
G --> H
H --> I
I --> J
J --> K
K --> A
B --> A
C --> A
K --> L
- Python 3.8 or higher
- pip package manager
streamlit
PyPDF2
python-dotenv
groq-
Clone the Repository
git clone https://github.com/your-username/smart-ats-analyzer.git cd smart-ats-analyzer -
Install Dependencies
pip install streamlit PyPDF2 python-dotenv groq
-
Configure Environment
- Create a
.envfile in the project root - Add your Groq API key:
GROQ_API_KEY=your_groq_api_key_here
- Get your API key from Groq Console
- Create a
-
Run the Application
streamlit run app.py
-
Access the App
- Open your browser to
http://localhost:8501 - Start analyzing your resume!
- Open your browser to
-
📄 Input Job Description
- Copy and paste the complete job description into the text area
- Include all requirements, qualifications, and job details
-
📎 Upload Your Resume
- Upload your resume in PDF format only
- Ensure the PDF contains selectable text (not scanned images)
-
🔍 Start Analysis
- Click the "🔍 Analyze Resume" button
- Wait for the AI processing to complete
-
📊 Review Results
- Overview Tab: View your ATS match score and JD alignment percentage
- Strengths Tab: See what's working well in your resume
- Improvements Tab: Identify missing keywords and critical areas for enhancement
- Recommendations Tab: Get personalized action items and a tailored professional summary
-
💾 Export Results
- Download your complete analysis report
- Use the recommendations to update your resume
smart-ats-analyzer/
├── 📄 app.py # Main Streamlit application
├── 📋 requirements.txt # Python dependencies
├── 🔐 .env # Environment variables (API keys)
├── 📖 README.md # Project documentation
└── 🎨 assets/ # Static assets (if any)
- Gradient Backgrounds: Beautiful purple-to-blue gradients
- Glassmorphism Effects: Translucent cards with backdrop blur
- Animated Elements: Subtle pulse animations for score displays
- Responsive Layout: Optimized for different screen sizes
- Tabbed Navigation: Organized content consumption
- Progress Indicators: Visual feedback during processing
- Error Handling: Clear error messages and troubleshooting
- Loading States: Spinner animations during analysis
- Temperature: 0.3 (balanced creativity and consistency)
- Max Tokens: 4000 (comprehensive responses)
- Model: llama-3.1-8b-instant (optimal speed-quality balance)
The application uses a carefully crafted prompt that:
- Simulates 15+ years of HR experience
- Provides structured markdown output
- Focuses on actionable, specific feedback
- Balances honesty with constructiveness
- 📄 Multi-format Support: DOCX, TXT file compatibility
- 🌍 Multi-language Analysis: Support for non-English resumes
- 📊 Historical Tracking: Save and compare multiple analyses
- 🤝 LinkedIn Integration: Direct profile import and analysis
- 📱 Mobile App: Native mobile application
- 🎯 Industry Templates: Role-specific optimization suggestions
- 📊 Analytics Dashboard: Usage statistics and insights
- 🔒 Enhanced Security: Advanced data protection measures
- ⚡ Performance Optimization: Faster processing and caching
- 🧪 A/B Testing: UI/UX optimization based on user feedback
PDF Not Reading Correctly:
- Ensure PDF contains selectable text (not scanned images)
- Try a different PDF or recreate from Word document
API Key Errors:
- Verify your Groq API key is correctly set in
.env - Check API key validity at Groq Console
Slow Performance:
- Check internet connection
- Verify Groq API service status
Created with ❤️ by Your Name
Connect with me:
- 🐙 GitHub: [github.com/SimranShaikh20]
This project is licensed under the MIT License - see the LICENSE file for details.
- Groq for providing fast and reliable AI inference
- Streamlit for the amazing web framework
- PyPDF2 for PDF processing capabilities
- The open-source community for continuous inspiration
If this tool helped you land your dream job, consider:
- ⭐ Starring this repository
- 🐛 Reporting bugs or suggesting features
Made with ❤️ for job seekers worldwide 🌍