CareerMentorAI: AI-Powered Career Guidance Platform

CareerMentorAI is a professional, secure, and intelligent web application designed to guide students through their career journey. It leverages the power of AI to provide personalized career roadmaps, resume analysis, and tailored document generation, replacing uncertainty with a clear, data-driven plan for success.

🐳 Docker Image Available: https://hub.docker.com/repository/docker/johannes613/ai-career-mentor

CI/CD Enabled with GitHub Actions: automatically builds and pushes the Docker image on every push to the main branch. The workflow file is available in the repository under: .github/workflows/docker-build.yml

---

Live Preview

Deployed Site: https://ai-career-mentor.vercel.app/dashboard

Demo

---

The Problem

• Unstructured Career Planning: Students often lack a clear, step-by-step guide to prepare for their desired career.
• Generic Resumes & Cover Letters: Creating application documents tailored to specific job descriptions is time-consuming and difficult.
• Skill Gaps: Students are often unaware of the specific skills they need to develop to become competitive candidates.
• Lack of Immediate Guidance: Getting quick, reliable answers to specific career questions can be challenging.

CareerMentorAI solves these challenges by providing a suite of integrated, AI-driven tools in a single, professional platform.

---

Core Features

1. AI-Powered Tools Suite

• Resume Analyzer: Upload a resume to receive an instant AI-powered score, detailed feedback on sections like Experience and Skills, and actionable tips for improvement.
• Career Roadmap Generator: Describe a career goal and generate a visual, interactive roadmap of skills to learn and steps to take, powered by React Flow.
• Cover Letter Generator: Automatically create cover letters tailored to a specific job description by providing key details.

2. Interactive Dashboards & Document Management

• Student Dashboard: An at-a-glance view of key metrics, skill progress, and recommended courses.
• Workspace: A central hub to access all AI tools and view a history of generated documents.
• My Documents Page: A dedicated section to view, filter, and manage all generated resumes, cover letters, and roadmaps.

3. AI Career Assistant Chatbot

• An integrated chatbot, available on all pages, for instant answers to career-related questions.
• Features a professional UI with simulated typing and a welcoming, branded experience.

---

Tech Stack

Layer	Technologies Used
Frontend	React, Material-UI, JavaScript
AI / Generation	Google Gemini API
Text & Document Processing	OCR (Tesseract.js), NLP libraries
Charts & Visualizations	Recharts, React Flow
PDF Rendering	React-PDF
UI/UX	Lucide React (Icons), Figma (Prototyping)
Containerization	Docker
CI/CD	GitHub Actions (build & push to Docker Hub on push to main)

---

Getting Started Locally

Prerequisites

• Node.js (v18+)
• npm (Node Package Manager)
• A `.env` file for your Gemini API Key

Installation

1. Clone the repository:

   git clone https://github.com/your-username/ai-career-mentor.git
   cd ai-career-mentor

2. Install dependencies:

   npm install

3. Set up PDF Worker (for Resume Analyzer):

   # On Mac/Linux or Git Bash
   cp ./node_modules/pdfjs-dist/build/pdf.worker.mjs ./public/
   On Windows CMD
   
   copy .\node_modules\pdfjs-dist\build\pdf.worker.mjs .\public\

4. Run the application:

   npm start

   The application will be available at https://ai-career-mentor.vercel.app/dashboard