🚀 AI Resume Optimizer

Elevate your career with AI-driven resume optimization. This application analyzes your resume, provides a compatibility score, and generates a professionally rewritten version optimized for Applicant Tracking Systems (ATS).

---

✨ Features

• ATS Analysis: Get a comprehensive score (0-100) based on industry standards.
• Actionable Feedback: Identify key strengths, critical weaknesses, and missing keywords.
• AI-Powered Rewriting: Instantly transform your resume with high-impact, professional phrasing using Google Gemini 1.5/2.5 Flash.
• Professional Preview: View your improved resume in a clean, professional "Paper Design" format.
• Multi-Format Export: Download your optimized resume as PDF, Word (.docx), or Markdown.
• Secure Handling: API Keys are stored locally in your browser, never on our servers.

---

🛠️ Tech Stack

Frontend

• Framework: React 19
• Build Tool: Vite
• Icons: Lucide React
• Markdown Rendering: React Markdown
• Exports: html2pdf.js, docx, file-saver
• Styling: Vanilla CSS (Custom Vibrant Modern SaaS Theme)

Backend

• Framework: FastAPI (Python)
• AI Model: Google Gemini API
• PDF Processing: pdfminer.six
• Asynchronous Processing: Python asyncio

---

🚀 Getting Started

Prerequisites

• Python 3.8+
• Node.js & npm
• A Google Gemini API Key

🔑 How to get a Google Gemini API Key

1. Go to Google AI Studio.
2. Sign in with your Google account.
3. Click on the "Create API key" button.
4. Choose a project or create a new one.
5. Copy your API key. (Keep it safe! You'll need to enter it in the app).

Installation

1. Clone the project:

   git clone https://github.com/Mavi9412/ai-resume-optimizer.git
   cd ai-resume-optimizer

2. Setup Backend:

   cd backend
   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   pip install -r requirements.txt
   uvicorn main:app --reload

3. Setup Frontend:

   cd ../frontend
   npm install
   npm run dev

4. Open the App: Navigate to http://localhost:5173 in your browser.

---

📖 How to Use

1. Enter API Key: Provide your Google Gemini API key in the secure input field.
2. Upload Resume: Drop your resume in PDF format into the upload zone.
3. Analyze: Review your ATS score and detailed feedback.
4. Generate: Click "Auto-Rewrite Resume" to see the AI's professional version.
5. Export: Choose your preferred format (PDF, Word, or Markdown) and download!

---

🤝 Contributing

We love contributions! Whether it's fixing a bug, adding a new feature, or improving documentation:

1. Fork the repository.
2. Create a branch for your feature (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

Please ensure your code follows the existing style and includes comments where necessary.

---

---

📧 Contact

Ameer Muavia - LinkedIn

Project Link: https://github.com/Mavi9412/ai-resume-optimizer