🚀 Resume Analyzer Pro

AI-powered resume analysis tool that gives you instant scores and improvement suggestions!

📊 ANALYZE • 🎯 OPTIMIZE • 🚀 SUCCEED

🎬 Live Demo

✨ Features

• 📊 Resume Scoring - ML-powered analysis with TF-IDF + XGBoost
• 🤖 AI Suggestions - Gemini-generated improvement tips
• 📄 PDF Upload - Easy drag-and-drop interface
• 📱 Responsive Design - Works on all devices
• ⚡ Fast Results - Get insights in seconds

🛠 Tech Stack

• Frontend: HTML, CSS, Tailwind, JavaScript
• Backend: FastAPI(Python)
• ML: scikit-learn, TF-IDF, XGBoost
• AI: Google Gemini API
• Deployment: Vercel+Render

🚀 Quick Start

1. Clone Repository

git clone https://github.com/yourusername/resume-analyzer.git
cd resume-analyzer

2. Backend Setup

cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

3. Environment Variables

# Create .env file
OPENAI_API_KEY=your_openai_api_key_here

4. Run Backend

uvicorn main:app --reload

5. Run Frontend

cd frontend
python -m http.server 8080
# OR open index.html in browser

Visit http://localhost:8080 to start analyzing resumes!

📁 Project Structure

Resume-Analyzer/
│
├── Backend/                     # Backend (API + ML Model)
│   ├── Backend.py                # Main backend application (Flask/FastAPI)
│   ├── Final.ipynb               # Model training & experiments notebook
│   ├── final_model.joblib        # Trained ML model (XGBoost / Classifier)
│   ├── final_vectorizer.joblib   # TF-IDF vectorizer
│   ├── requirements.txt          # Backend dependencies
│   └── __pycache__/              # Compiled python cache (ignored)
│
├── Frontend/                    # Frontend (React + Vite + Tailwind)
│   ├── index.html                # Entry point
│   ├── package.json              # Node dependencies
│   ├── vite.config.ts            # Vite config
│   ├── tailwind.config.js        # Tailwind config
│   ├── src/                      # React source files
│   │   ├── app.jsx               # Main app logic
│   │   ├── main.jsx              # React DOM render
│   │   ├── App.css               # App styles
│   │   ├── index.css             # Global styles
│   │   └── assets/               # Static assets (icons, images)
│   └── public/                   # Public static files
│
├── Data/                        # Dataset & Model JSON
│   ├── resume_job_matching_dataset.csv
│   └── resume_model.json
│
├── Screenshots/                 # App demo screenshots
│   ├── upload_resume.png
│   ├── score_result.png
│   ├── suggestions.png
│   └── mobile_view.png
│
├── README.md                    # Project documentation
└── .gitignore                   # Git ignore rules

🎯 How to Use

1. Upload your resume (PDF format)
2. Click "Analyze Resume" button
3. Get your score (0-100) and AI suggestions
4. Improve your resume based on feedback

🎬 User Journey Flow

Step 1: Upload	Step 2: Analysis	Step 3: Suggestions	Step 4: Results
Easy drag & drop	ML-powered scoring	AI recommendations	Track improvements

---

✨ Key Features Showcase

🎨 Beautiful UI/UX ✅ Clean, modern interface ✅ Responsive design ✅ Intuitive navigation ✅ Professional aesthetics	🧠 Smart Analytics ✅ ML-powered scoring ✅ Detailed breakdowns ✅ Performance metrics ✅ Visual indicators
🤖 AI Recommendations ✅ GPT-powered insights ✅ Personalized tips ✅ Actionable advice ✅ Industry-specific suggestions	📈 Progress Tracking ✅ Success metrics ✅ Improvement tracking ✅ Goal achievement ✅ Performance history

---

📱 Mobile & Desktop Ready

💻 Desktop View	📱 Mobile Responsive
	Perfect for all screen sizes!

🤝 Contributing

1. Fork the repo
2. Create feature branch (git checkout -b feature/new-feature)
3. Commit changes (git commit -am 'Add new feature')
4. Push to branch (git push origin feature/new-feature)
5. Create Pull Request

📝 Requirements

Backend Dependencies

• FastAPI for web framework
• scikit-learn for machine learning
• pandas and numpy for data processing
• XGBoost for advanced ML models
• Gemini for AI suggestions
• PyPDF2 for PDF processing
• python-dotenv for environment variables

📄 License

MIT License - feel free to use this project for learning and development!

---

⭐ Star this repo if it helped you!

Made with ❤️ by Sonal Singh