Thanks to visit codestin.com
Credit goes to github.com

Skip to content

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.

Notifications You must be signed in to change notification settings

Nishant-0203/ResumeUp.AI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

38 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 Credentials โ†’ Create Credentials โ†’ OAuth 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

No packages published

Languages