Skip to content

Nishant-0203/ResumeUp.AI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 

Repository files navigation

🎯 ResumeUp.AI

Your AI-Powered Career Companion

MIT License Node.js React MongoDB AI Powered

Transform your resume into your ticket to success with AI-driven insights and personalized career guidance.

✨ Features🚀 Quick Start📖 Documentation👨‍💻 Author


🚀 Overview

ResumeUp.AI is an intelligent career companion that leverages Google's Gemini AI to analyze your resume, identify skill gaps, and provide personalized job recommendations. Whether you're a fresh graduate or an experienced professional, ResumeUp.AI helps you understand your strengths, improve your weaknesses, and discover opportunities tailored to your profile.

🎯 Why ResumeUp.AI?

AI Analysis
🤖 Smart AI Analysis
Advanced resume parsing with actionable feedback
Skill Development
📚 Skill Development
Personalized quizzes and learning paths
Job Matching
💼 Job Matching
AI-powered job recommendations

The platform goes beyond simple resume parsing — it generates dynamic quizzes based on your skill gaps, tracks your progress, and provides actionable insights to accelerate your career growth.


✨ Features

🔍 AI-Powered Resume Analysis
  • 📄 Upload PDF resumes and get instant AI analysis
  • 📊 Receive ATS (Applicant Tracking System) compatibility scores
  • 💪 Detailed breakdown of strengths and weaknesses
  • 🎯 Personalized improvement recommendations
  • 📈 Track analysis history and progress over time
💼 Personalized Job Recommendations
  • 🤝 AI-driven job matching based on your skills
  • 🎖️ Matching scores (0-100) for each opportunity
  • 📍 Remote, hybrid, and on-site options
  • 💰 Salary estimates and experience level requirements
  • 🚀 Next steps and application strategies
📚 Dynamic Quiz Generation
  • 🧠 AI-generated questions based on your skill gaps
  • 📝 Multi-category assessments (Technical, Leadership, Soft Skills)
  • ✅ Detailed explanations for every answer
  • 📊 Performance analytics and progress tracking
  • 🎯 Targeted learning for maximum improvement
📈 Progress Tracking Dashboard
  • 🏆 Achievement tracking and badges
  • 📊 Visual analytics with charts and graphs
  • 📅 Career milestone timeline
  • 🔔 Smart notifications for new opportunities
  • 📱 Responsive design for all devices
🔐 Secure Authentication & Profile Management
  • 🔑 JWT-based secure authentication
  • 🌐 Google OAuth 2.0 integration
  • 🖼️ Profile picture upload via Cloudinary
  • ⚡ Rate limiting for API security
  • 🛡️ Environment validation and error handling

🛠️ Tech Stack

Frontend Technologies

React Vite TailwindCSS React Router Framer Motion

Backend Technologies

Node.js Express.js MongoDB JWT Passport

AI & Cloud Services

Google AI Cloudinary

📦 Complete Tech Stack Details

Frontend

  • ⚛️ React 19 + Vite - Lightning-fast development
  • 🎨 Tailwind CSS 4 + shadcn/ui - Beautiful, accessible components
  • 🎭 Framer Motion - Smooth animations and transitions
  • 🧭 React Router DOM - Client-side routing
  • 📡 Axios - HTTP client for API calls
  • 📊 Recharts - Data visualization and charts

Backend

  • 🚀 Node.js + Express.js - Fast, scalable server
  • 🗄️ MongoDB + Mongoose - NoSQL database with ODM
  • 🔐 JWT + Passport.js - Secure authentication with Google OAuth
  • 📤 Multer + Cloudinary - File upload and cloud storage
  • 🛡️ Express Rate Limiter - API security and abuse prevention
  • ⚠️ Custom Error Handler - Centralized error management

AI & APIs

  • 🤖 Google Generative AI (Gemini) - Advanced language model for analysis
  • 📄 pdf-parse - Extract text from PDF resumes
  • 🌐 RESTful API - Clean, maintainable API architecture

⚙️ Installation & Setup

📋 Prerequisites

Before you begin, ensure you have the following installed and configured:

Requirement Version Purpose
🟢 Node.js v14+ Runtime environment
🍃 MongoDB Latest Database (local or Atlas)
🔑 Gemini API Key - Get it here
☁️ Cloudinary Account - Sign up free
🌐 Google OAuth - Console setup

🚀 Quick Start Guide

Step 1️⃣: Clone the Repository
# Clone the project
git clone https://github.com/Nishant-0203/ResumeUp.AI.git

# Navigate to project directory
cd ResumeUp.AI
Step 2️⃣: Backend Configuration
# Navigate to backend folder
cd backend

# Install dependencies
npm install

# Create .env file in backend directory
# Copy and paste the following configuration:

Create backend/.env file:

# Server Configuration
PORT=5000
FRONTEND_URL=http://localhost:5173

# Database
MONGODB_URI=mongodb://localhost:27017/resumeup
# Or use MongoDB Atlas:
# MONGODB_URI=your_mongoDB_link

# Authentication
JWT_SECRET=your_super_secret_jwt_key_change_this_in_production
SESSION_SECRET=your_session_secret_key

# Google OAuth 2.0 (Get from: https://console.cloud.google.com/)
GOOGLE_CLIENT_ID=your_google_client_id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=your_google_client_secret

# Google Gemini AI (Get from: https://ai.google.dev/)
GOOGLE_API_KEY=your_gemini_api_key

# Cloudinary (Get from: https://cloudinary.com/console)
CLOUDINARY_CLOUD_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_cloudinary_api_key
CLOUDINARY_API_SECRET=your_cloudinary_api_secret
# Start backend server
npm run dev

# You should see:
# ✅ MongoDB Connected Successfully
# ✅ Server is running on port 5000
Step 3️⃣: Frontend Configuration
# Open new terminal and navigate to frontend
cd frontend

# Install dependencies
npm install

# Create .env file in frontend directory

Create frontend/.env file:

# API Base URL
VITE_API_BASE_URL=http://localhost:5000/api
# Start frontend development server
npm run dev

# You should see:
# ✅ Local: http://localhost:5173/
Step 4️⃣: Access the Application

🎉 Your app is now running!


🔧 Configuration Guides

📘 How to Get Google Gemini API Key
  1. Visit Google AI Studio
  2. Click "Get API Key"
  3. Create a new project or select existing
  4. Copy your API key and paste in .env
📘 How to Setup Google OAuth
  1. Go to Google Cloud Console
  2. Create a new project
  3. Enable Google+ API
  4. Go to CredentialsCreate CredentialsOAuth 2.0 Client ID
  5. Set Authorized redirect URIs:
    • http://localhost:5000/auth/google/callback
  6. Copy Client ID and Client Secret to .env
📘 How to Setup Cloudinary
  1. Sign up at Cloudinary
  2. Go to Dashboard
  3. Copy Cloud Name, API Key, and API Secret
  4. Paste them in your .env file
📘 MongoDB Setup (Local or Atlas)

Option A: Local MongoDB

# Install MongoDB locally and run:
mongod

Option B: MongoDB Atlas (Cloud)

  1. Sign up at MongoDB Atlas
  2. Create a free cluster
  3. Get connection string
  4. Replace <password> with your database user password
  5. Paste in .env as MONGODB_URI

💻 Usage

🎬 Getting Started

1️⃣ Create Your Account

  • 🆕 Sign up with email and password
  • 🌐 Or use Google OAuth for instant access
  • ✅ Secure JWT-based authentication

2️⃣ Upload Your Resume

  • 📄 Navigate to Analysis page
  • ⬆️ Upload your PDF resume (up to 5MB)
  • ⏱️ Wait for AI processing (usually < 30 seconds)

3️⃣ Get AI-Powered Insights

  • 📊 View your ATS compatibility score
  • 💪 See strengths highlighted
  • ⚠️ Identify weaknesses to improve
  • 🎯 Get personalized recommendations

4️⃣ Take Skill Assessment

  • 🧠 Auto-generated quizzes based on gaps
  • 📝 Answer multiple-choice questions
  • ✅ Get instant feedback with explanations
  • 📈 Track your improvement over time

5️⃣ Discover Job Opportunities

  • 💼 AI-matched job recommendations
  • 🎖️ See matching scores (0-100)
  • 💰 View salary ranges and requirements
  • 🚀 Get actionable next steps

6️⃣ Monitor Your Progress

  • 🏆 Unlock achievements and badges
  • 📊 View analytics dashboard
  • 📅 Track your career journey
  • 🔔 Get notified of new opportunities

📸 Screenshots

🏠 Landing Page

Beautiful, modern interface with smooth animations

📊 Dashboard

Track your progress, skills, and achievements

🤖 AI Analysis

Detailed resume feedback with actionable insights

💼 Job Recommendations

Personalized opportunities matched to your profile


🔗 Links & Resources

Resource Link
🏠 GitHub Repository github.com/Nishant-0203/ResumeUp.AI
🚀 Live Demo Coming Soon 🚧
📖 API Documentation Postman Collection
🐛 Report Issues GitHub Issues
💡 Feature Requests Discussions

🤝 Contributing

Contributions are always welcome! 💖

How to Contribute
  1. Fork the repository
  2. Clone your fork:
    git clone https://github.com/your-username/ResumeUp.AI.git
  3. Create a feature branch:
    git checkout -b feature/amazing-feature
  4. Commit your changes:
    git commit -m "Add some amazing feature"
  5. Push to the branch:
    git push origin feature/amazing-feature
  6. Open a Pull Request

📝 Contribution Guidelines

  • Write clean, maintainable code
  • Follow existing code style
  • Add comments for complex logic
  • Test your changes thoroughly
  • Update documentation if needed

👨‍💻 Author

Author

Nishant Bhalla

Full-Stack Developer | AI Enthusiast | Open Source Contributor

Email GitHub LinkedIn

"Building solutions that make a difference, one line of code at a time."


🧠 Key Learnings & Highlights

💡 What Makes This Project Special?

🎯 AI Integration

Implemented Google's Gemini AI for intelligent resume analysis, job matching, and dynamic quiz generation with context-aware responses.

🔐 Security First

JWT authentication, OAuth 2.0, rate limiting, environment validation, and secure file upload practices.

⚡ Performance

Optimized API responses, efficient database queries, and responsive UI with smooth animations.

🎓 Technical Achievements

  • Full-Stack Mastery: End-to-end implementation from database to UI
  • AI/ML Integration: Real-world application of generative AI
  • RESTful API Design: Clean, scalable, and maintainable architecture
  • Modern React Patterns: Context API, custom hooks, and component composition
  • Cloud Services: Cloudinary for media management, MongoDB Atlas for database
  • Security Best Practices: Authentication, authorization, and data validation
  • Error Handling: Comprehensive error management and user feedback
  • Responsive Design: Mobile-first approach with Tailwind CSS

🔮 Future Enhancements

  • 📱 Mobile app (React Native)
  • 🎥 Video interview practice with AI feedback
  • 📄 Resume builder with ATS-optimized templates
  • 🌐 Multi-language support
  • 🔗 LinkedIn profile integration
  • 📊 Advanced analytics dashboard
  • 💬 Real-time chat support
  • 📧 Email notifications for job matches

🛡️ License

This project is licensed under the MIT License - see the LICENSE file for details.


💬 Support & Feedback

Found this helpful? Show your support!

Star this repository if you found it useful!

🐛 Found a bug? Open an issue

💡 Have an idea? Start a discussion

📧 Need help? Email me


Connect With Me

GitHub followers GitHub stars


Code

Made with ❤️ and ☕ by Nishant Bhalla

"Empowering careers through AI-driven insights"


⚡ Quick Links

🏠 Home✨ Features🛠️ Tech Stack⚙️ Setup📖 Usage👨‍💻 Author


© 2025 ResumeUp.AI. All rights reserved.

About

AI-powered resume analysis and career guidance platform using Google Gemini AI, React, Node.js, and MongoDB. Get instant resume feedback, personalized job recommendations, and skill assessments.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages