Skip to content

VaidhyaMegha/FitMatch

 
 

Repository files navigation

FitMatch.AI

FitMatch.AI is an intelligent resume analysis tool that helps job seekers understand how well their qualifications match a specific job description. Using advanced AI, it provides a detailed breakdown of the match, highlighting strengths, areas for improvement, and personalized recommendations.

Features

  • Compatibility Score: Get an overall match percentage between your resume and the job description
  • Skills Analysis: See which of your technical skills match the job requirements and which are missing
  • Experience Evaluation: Understand how your work experience aligns with the role's requirements
  • Education Fit: Compare your educational background with the job's educational requirements
  • Personalized Recommendations: Get actionable advice to improve your resume and application
  • Detailed Report: A comprehensive breakdown of your fit for the position

Tech Stack

  • Frontend: Next.js 14 with TypeScript
  • UI: Tailwind CSS with Shadcn UI components
  • AI: Google's Generative AI (via Genkit)
  • Form Handling: React Hook Form with Zod validation
  • State Management: React Hooks
  • Icons: Lucide React
  • Charts: Recharts

Getting Started

Prerequisites

  • Node.js 18+ and npm/yarn
  • Google Cloud account with Generative AI API enabled

Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/fitmatch-ai.git
    cd fitmatch-ai
  2. Install dependencies:

    npm install
    # or
    yarn
  3. Set up environment variables: Create a .env file in the root directory and add your Google Cloud credentials:

    GOOGLE_APPLICATION_CREDENTIALS="path/to/your/service-account-key.json"
    
  4. Run the development server:

    npm run dev
    # or
    yarn dev
  5. Open http://localhost:3000 in your browser.

Usage

  1. Paste your resume text in the "Your Resume" text area
  2. Paste the job description in the "Job Description" text area
  3. Click "Analyze Fit" to generate your personalized report
  4. Review the detailed analysis and recommendations

Project Structure

src/
├── app/                  # Next.js app router
│   ├── actions.ts        # Server actions for form submission
│   └── page.tsx          # Main page component
├── components/           # Reusable UI components
│   ├── ui/               # Shadcn UI components
│   ├── report-card.tsx   # Component for displaying report cards
│   └── report-display.tsx # Main report display component
├── ai/
│   ├── flows/            # AI flow definitions
│   │   └── generate-fit-report.ts  # Main AI analysis flow
│   └── genkit.ts         # Genkit configuration
└── lib/
    └── utils.ts          # Utility functions

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Acknowledgments

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 97.5%
  • CSS 1.6%
  • Other 0.9%