Skip to content

AI-powered resume analyzer that compares resumes against job descriptions. Built with React, TypeScript & N8N workflows. Get match scores, keyword suggestions & improvement tips. Upload resume as PDF & paste text of JD for instant analysis.

Notifications You must be signed in to change notification settings

Nitish-AI-Labs/AI-Resume-Helper

Repository files navigation

AI Resume Helper πŸ€–πŸ“„

Live Demo: https://ai-resume-helper-nine.vercel.app/

A cutting-edge web application that leverages AI to analyze resumes against job descriptions, providing actionable insights to help you land your dream job. Built with modern technologies and deployed for instant access.

AI Resume Helper

Live Demo License Contact

🌟 Features

🎯 Smart Resume Analysis

  • AI-powered comparison between resumes and job descriptions
  • Advanced keyword matching with weighted scoring
  • Professional algorithms for comprehensive evaluation

πŸ“ Multi-Format Support

  • PDF Upload - Upload resume files with advanced text extraction
  • Direct Text Input - Paste job descriptions for optimal accuracy
  • File Validation - Secure upload with size and type restrictions

πŸ“Š Intelligent Scoring System

  • Match Percentage - Precise compatibility scoring
  • Keyword Analysis - Extract and highlight critical skills
  • Gap Identification - Identify missing keywords and requirements

πŸ’‘ Actionable Insights

  • Priority-Based Suggestions - High, medium, and low priority recommendations
  • ATS Optimization - Applicant Tracking System compatibility tips
  • Section-by-Section Analysis - Detailed improvement roadmap

πŸš€ Live Application

🌐 Access the app instantly: ai-resume-helper-nine.vercel.app

No installation required - start analyzing your resume in seconds!

πŸ› οΈ Tech Stack

Frontend

  • React - Modern React with hooks
  • TypeScript - Type-safe development
  • Tailwind - Utility-first styling
  • Vite - Lightning-fast development

Backend & AI

  • N8N - Visual workflow automation
  • AI - Advanced language processing
  • Professional PDF Processing - Enterprise-grade text extraction

Deployment

  • Vercel - Seamless hosting and CDN

🎯 How It Works

1. Upload Your Resume

Upload your PDF resume using our secure file handling system

2. Add Job Description

Paste the job description you're targeting for optimal matching

3. AI Analysis

Our advanced AI analyzes compatibility and generates detailed insights

4. Get Actionable Results

  • Match score percentage
  • Missing keywords identification
  • Priority-based improvement suggestions
  • ATS optimization recommendations

πŸ“Š Analysis Capabilities

Comprehensive Keyword Detection

  • Technical Skills: JavaScript, Python, React, AWS, Docker, etc.
  • Soft Skills: Leadership, Communication, Problem-solving
  • Industry Terms: Role-specific terminology and requirements
  • Action Verbs: Achievement-oriented language analysis

Intelligent Scoring

  • Weighted keyword matching
  • Resume structure evaluation
  • Achievement quantification assessment
  • Professional formatting analysis

Improvement Categories

  • πŸ”΄ High Priority: Critical missing elements
  • 🟑 Medium Priority: ATS and formatting improvements
  • 🟒 Low Priority: Enhancement opportunities

πŸ’Ό For Developers

Frontend Development

The frontend code is open source and perfect for learning:

# Clone the repository
git clone https://github.com/yourusername/ai-resume-helper
cd ai-resume-helper

# Install dependencies
npm install

# Start development server
npm run dev

Backend Integration

The powerful N8N workflow that drives the AI analysis is available for purchase:

What You Get:

  • Complete N8N workflow configuration
  • AI integration setup (Gemini API)
  • Professional PDF processing pipeline
  • Setup documentation and support
  • Commercial usage rights

Contact for Workflow:

πŸ—οΈ Project Structure

ai-resume-helper/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/              # React components
β”‚   β”‚   β”œβ”€β”€ FileUpload.tsx       # Secure file upload
β”‚   β”‚   β”œβ”€β”€ JobDescriptionInput.tsx  # Job input interface
β”‚   β”‚   β”œβ”€β”€ ResultsDisplay.tsx   # Analysis results UI
β”‚   β”‚   └── LoadingSpinner.tsx   # Loading states
β”‚   β”œβ”€β”€ services/
β”‚   β”‚   └── api.ts              # N8N workflow integration
β”‚   β”œβ”€β”€ types/
β”‚   β”‚   └── index.ts            # TypeScript definitions
β”‚   β”œβ”€β”€ utils/
β”‚   β”‚   └── fileValidation.ts   # Upload security
β”‚   β”œβ”€β”€ App.tsx                 # Main application
β”‚   └── main.tsx               # Entry point
β”œβ”€β”€ public/                     # Static assets
β”œβ”€β”€ package.json               # Dependencies
└── vercel.json               # Deployment config

πŸš€ Deployment Guide

Deploy Your Own Instance

  1. Fork the Repository
  2. Connect to Vercel
  3. Configure Environment Variables
  4. Deploy Instantly

Environment Variables

VITE_API_ENDPOINT=your-n8n-webhook-url
VITE_APP_NAME=AI Resume Helper

πŸ“ˆ Performance & Features

  • ⚑ Lightning Fast - Optimized loading and analysis
  • πŸ”’ Secure - Client-side processing with secure uploads
  • πŸ“± Responsive - Perfect on desktop, tablet, and mobile
  • 🌐 Global CDN - Fast access worldwide via Vercel
  • 🎨 Modern UI - Clean, intuitive interface design

🀝 Contributing

I Welcome contributions to the frontend:

  1. Fork the repository
  2. Create a feature branch
  3. Make your improvements
  4. Submit a pull request

For backend workflow contributions, please contact me directly.

πŸ’° Pricing & Licensing

Frontend

  • βœ… Free & Open Source - MIT License
  • βœ… Commercial Use - Allowed
  • βœ… Educational Use - Encouraged

AI Workflow

  • πŸ’Ό Commercial License - Required for business use
  • πŸŽ“ Educational Discount - Available for students
  • πŸ› οΈ Custom Features - Development available

Contact: nitishb057@gmail.com

πŸ”§ Configuration & Setup

API Configuration

Update the endpoint in src/services/api.ts:

const API_ENDPOINT = process.env.VITE_API_ENDPOINT || 'your-n8n-webhook-url';

File Upload Settings

Customize limits in src/utils/fileValidation.ts:

export const FILE_CONFIG = {
  maxSizeInMB: 10,
  allowedTypes: ['application/pdf'],
  maxFiles: 1
};

πŸ› Troubleshooting

Common Issues

Application Not Loading

  • Check browser console for errors
  • Verify network connection
  • Try refreshing the page

Upload Issues

  • Ensure file is PDF format
  • Check file size (max 10MB)
  • Try a different browser

Analysis Not Working

  • The N8N workflow backend is required for full functionality
  • Contact us for workflow access

Getting Help

  • πŸ“§ Email Support: nitishb057@gmail.com
  • πŸ’¬ GitHub Issues: For frontend bugs
  • πŸ“ž Workflow Support: Available for customers

πŸŽ“ Educational Resources

Perfect for learning modern web development:

  • React 18 Patterns - Modern hooks and component design
  • TypeScript Integration - Type-safe development practices
  • API Integration - RESTful service consumption
  • File Handling - Secure upload implementations
  • UI/UX Design - Modern interface patterns

🌟 Acknowledgments

  • Vercel - Seamless deployment platform
  • N8N - Powerful workflow automation
  • Tailwind CSS - Beautiful utility-first styling
  • Lucide React - Clean, consistent icons
  • Pexels - High-quality stock imagery

πŸ“ž Contact & Support

Developer

Business Inquiries

  • Custom development
  • Enterprise solutions
  • Workflow licensing
  • Technical consulting

πŸš€ Try It Now | πŸ’Ό Get Workflow | ⭐ Star on GitHub

Built with ❀️ using cutting-edge web technologies

About

AI-powered resume analyzer that compares resumes against job descriptions. Built with React, TypeScript & N8N workflows. Get match scores, keyword suggestions & improvement tips. Upload resume as PDF & paste text of JD for instant analysis.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •