Skip to content

Repository files navigation

ResumeIQ-AI

An AI-powered ATS Resume Analyzer that helps job seekers optimize resumes, identify skill gaps, and improve interview readiness through intelligent resume evaluation and job description matching.

React FastAPI PostgreSQL Python License Status


Overview

ResumeIQ-AI is a full-stack AI application designed to evaluate resumes against modern Applicant Tracking System (ATS) standards. It analyzes uploaded resumes, compares them with job descriptions, extracts relevant skills and keywords, calculates ATS compatibility, and generates AI-powered recommendations to improve hiring outcomes.

The platform combines intelligent document parsing, natural language processing, and modern web technologies to provide an intuitive experience for students, professionals, and recruiters.


Key Features

  • AI-powered resume analysis
  • ATS compatibility scoring
  • Resume parsing (PDF & DOCX)
  • Job description matching
  • Keyword extraction and optimization
  • Skill gap identification
  • Personalized AI recommendations
  • Secure JWT-based authentication
  • Responsive and modern user interface
  • RESTful API architecture

Technology Stack

Frontend

  • React
  • Vite
  • Tailwind CSS
  • Axios
  • React Router
  • Framer Motion
  • Recharts

Backend

  • FastAPI
  • SQLAlchemy
  • PostgreSQL
  • JWT Authentication
  • Google Gemini API

Database

  • Neon PostgreSQL

Deployment

  • Frontend — Vercel
  • Backend — Render

System Architecture

                React + Vite
                      │
                      ▼
            FastAPI REST API
                      │
         ┌────────────┴────────────┐
         ▼                         ▼
 Google Gemini API          PostgreSQL (Neon)

Project Structure

ResumeIQ-AI
├── frontend
│   ├── src
│   ├── public
│   └── package.json
│
├── backend
│   ├── app
│   ├── main.py
│   ├── requirements.txt
│   └── runtime.txt
│
└── README.md

Live Application

Frontend

https://resume-iq-ai-bice.vercel.app/

Backend API (https://resumeiq-ai-1.onrender.com)


Getting Started

Clone Repository

git clone https://github.com/HarshMisra1102/ResumeIQ-AI.git
cd ResumeIQ-AI

Backend

cd backend

python -m venv venv

# Windows
venv\Scripts\activate

pip install -r requirements.txt

uvicorn app.main:app --reload

Frontend

cd frontend

npm install

npm run dev

Environment Variables

Backend

DATABASE_URL=

SECRET_KEY=

GEMINI_API_KEY=

ACCESS_TOKEN_EXPIRE_MINUTES=60

Frontend

VITE_API_BASE_URL=

Roadmap

  • Resume Template Generator
  • AI Cover Letter Generator
  • LinkedIn Profile Analysis
  • Interview Readiness Score
  • Recruiter Dashboard
  • Resume Version History
  • Multi-language Support

Contributing

Contributions are welcome.

  1. Fork the repository.
  2. Create a feature branch.
  3. Commit your changes.
  4. Submit a Pull Request.

License

Distributed under the MIT License.


Author

Harsh Misra

B.Tech Computer Science (Artificial Intelligence & Machine Learning)

Passionate about Artificial Intelligence, Full-Stack Development, Backend Engineering, and Open Source.

GitHub: https://github.com/HarshMisra1102


Acknowledgements

  • FastAPI
  • React
  • PostgreSQL
  • Google Gemini
  • Vercel
  • Render

If you find this project useful, consider giving it a ⭐.

About

ResumeIQ-AI is an AI-powered resume analyzer that evaluates resumes for ATS compatibility, identifies missing keywords and skills, provides personalized improvement suggestions, and generates a resume score. It helps job seekers optimize resumes to improve visibility and increase interview opportunities.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages