Skip to content

ramadanrexhepi/ResuMind

Repository files navigation

ResuMind - AI Resume Optimizer

Transform your resume with AI-powered analysis and optimization. Get professional, ATS-friendly resumes in minutes.

License Node MongoDB

Features

  • ** Resume Upload & Analysis** - Upload PDF or DOCX resumes for instant AI-powered feedback
  • ** LinkedIn Profile Analysis** - Analyze LinkedIn profiles directly with URL input
  • ** GPT-4o Integration** - Leverage OpenAI's latest model for intelligent resume optimization
  • ** Professional PDF Generation** - Create beautifully formatted, ATS-compatible resumes
  • ** Detailed Scoring** - Get comprehensive scores across multiple resume categories
  • ** ATS Optimization** - Ensure your resume passes Applicant Tracking Systems
  • ** Personalized Recommendations** - Receive actionable feedback to improve your resume

Screenshots

Coming soon - Add screenshots of your app here

Tech Stack

Frontend

  • React.js - UI framework
  • CSS3 - Styling with modern design
  • Fetch API - HTTP requests

Backend

  • Node.js - Runtime environment
  • Express.js - Web framework
  • MongoDB Atlas - Cloud database
  • OpenAI GPT-4o - AI analysis engine
  • Puppeteer - PDF generation
  • Multer - File upload handling
  • PDF-Parse - PDF text extraction
  • Mammoth - DOCX file processing

Getting Started

Prerequisites

  • Node.js (v18 or higher)
  • MongoDB Atlas account (free tier available)
  • OpenAI API key

Installation

  1. Clone the repository
 git clone https://github.com/ramadanrexhepi/ResuMind.git cd ResuMind
  1. Install backend dependencies
 cd backend npm install
  1. Install frontend dependencies
 cd ../frontend npm install
  1. Configure environment variables

    Create a .env file in the backend directory:

 PORT=5050 MONGODB_URI=mongodb+srv://your_username:your_password@cluster0.xxxxx.mongodb.net/resumind OPENAI_API_KEY=sk-your-openai-api-key-here NODE_ENV=development
  1. Start the backend server
 cd backend npm start

Backend will run on http://localhost:5050

  1. Start the frontend (in a new terminal)
 cd frontend npm start

Frontend will run on http://localhost:3000

Usage

  1. Upload Your Resume

    • Navigate to the upload page
    • Choose a PDF or DOCX file
    • Click "Analyze Resume"
  2. Or Analyze LinkedIn Profile

    • Enter your LinkedIn profile URL
    • Click "Analyze Profile"
  3. Review Analysis

    • View detailed scores and feedback
    • Read personalized recommendations
  4. Generate Optimized Resume

    • Click "Generate Optimized Resume"
    • Download your professional PDF

API Endpoints

Resume Analysis

POST /api/analyze-resume Content-Type: multipart/form-data Parameters: - resume: File (PDF or DOCX)

LinkedIn Analysis

POST /api/analyze-linkedin Content-Type: application/json Body: { "linkedinUrl": "https://www.linkedin.com/in/username" }

Generate Resume

POST /api/generate-resume Content-Type: application/json Body: { "resumeText": "Full resume text...", "linkedinUrl": "Optional LinkedIn URL" }

Environment Variables

Variable Description Required
PORT Backend server port Yes
MONGODB_URI MongoDB connection string Yes
OPENAI_API_KEY OpenAI API key Yes
NODE_ENV Environment (development/production) Yes

Project Structure

ResuMind/ ├── backend/ │ ├── server.js # Express server │ ├── routes/ # API routes │ ├── uploads/ # Temporary file storage │ ├── package.json │ └── .env # Environment variables (not in repo) ├── frontend/ │ ├── public/ # Static files │ ├── src/ │ │ ├── components/ # React components │ │ ├── App.js # Main app component │ │ └── index.js # Entry point │ └── package.json ├── .gitignore └── README.md 

Known Issues

  • Large file uploads (>10MB) may timeout
  • LinkedIn scraping may be rate-limited

Future Enhancements

  • Multiple resume templates
  • Resume comparison feature
  • Job description matching
  • Cover letter generation
  • Multi-language support
  • Mobile app

License

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

Author

Ramadan Rexhepi

Acknowledgments

  • OpenAI for GPT-4o API
  • MongoDB Atlas for cloud database
  • Create React App for frontend boilerplate

Releases

No releases published

Contributors

Languages