🌐 Career Pilot

An intelligent, AI-powered career platform that revolutionizes the job hunting experience through automated resume enhancement, intelligent job matching, AI mock interviews, corporate fellowships, and community-driven networking.

Features • Tech Stack • Getting Started • API Reference • Contributing

---

🌟 Overview

The AI Resume Builder & Career Platform is a comprehensive full-stack application designed to streamline and enhance the job search process. By leveraging cutting-edge AI technology (Google Gemini 2.5), real-time communication via Socket.IO, and intelligent automation through BullMQ job queues, this platform provides job seekers with powerful tools to succeed.

---

💡 Our Solution

We solve the modern job seeker's most painful challenges:

💎 Resume Optimization AI-powered resume enhancement using Google Gemini 2.5 with ATS scoring and Harvard-format templates.	🧊 Information Overload Smart job alerts with customizable filters (keywords, location, salary, employment type) delivered via real-time sockets.
📈 Application Tracking Visual Kanban-style job tracker with status management from Saved all the way to Offered.	🌐 Isolation & Networking Real-time community platform with channels, posts, direct messaging, and presence indicators.
📘 Skill Gaps & Portfolios AI-generated improvement suggestions, LinkedIn optimizations, and a drag-and-drop Portfolio Builder.	⚡ Time Consumption Automated job fetching, bulk processing via queues, and one-click resume downloads.

---

✨ Core Features

🤖 AI-Powered Resume Enhancement

• Smart Resume Enhancement: Transform ordinary resumes into ATS-optimized documents
• Professional Summary Generation: AI-crafted summaries tailored to target roles
• Improvement Suggestions: Actionable recommendations to strengthen your resume
• ATS Score Analysis: Get compatibility scores with detailed feedback
• Harvard Template Formatting: Industry-standard resume formatting

🎓 Career Pilot Fellowships

• Corporate Challenges: Companies post real-world challenges for students
• Student Proposals: Students submit proposals with cover letters and pricing
• Escrow Payments: Razorpay integration for secure payments until completion
• Real-time Chat: Direct messaging between corporate and students

🎤 AI Interview Prep

• Mock Interviews: AI-powered interview simulations
• Role-Specific Questions: Tailored questions based on target role
• Real-time Feedback: Instant AI evaluation of responses
• Multi-Round Support: Technical, behavioral, and HR round simulations

🖼️ Portfolio Builder & GitHub Intelligence

• AI Section Enhancement: Enhance your portfolio's hero, projects, and about sections using Gemini AI
• LinkedIn Profile Optimizer: AI-generated headline rewrites and skills gap analysis vs. industry peers
• Theme Selector: Choose from multiple portfolio themes to match your personal brand
• LinkedIn OAuth: Sign in with LinkedIn and auto-import profile data

---

🛠 Tech Stack

Frontend	Backend	Infrastructure
React 19 Vite 7 TailwindCSS 4 Framer Motion Socket.IO Client Zustand	Node.js 18+ Express.js MongoDB + Mongoose BullMQ + IORedis Google Gemini AI Razorpay API	Firebase Auth MongoDB Atlas Redis RapidAPI (JSearch) Netlify

---

🚀 Getting Started

Prerequisites

• Node.js 18.0+
• MongoDB instance (local or Atlas)
• Redis instance (for job queue)
• Firebase project with Firestore enabled
• Google Gemini API key

Quick Installation

# 1. Clone the repository
git clone https://github.com/ishwari418/career-pilot.git
cd career-pilot

# 2. Install backend dependencies
cd backend
npm install

# 3. Install frontend dependencies
cd ../frontend
npm install

Start the development servers:

# Backend (Port 5001)
npm run dev

# Frontend (Port 5173)
npm run dev

---

📂 Project Structure & Architecture

View Directory Structure

career-pilot/
├── backend/
│   ├── src/
│   │   ├── config/          # Firebase, AI, Socket, DB setup
│   │   ├── controllers/     # Route logic
│   │   ├── middleware/      # Auth, Rate limiting, Uploads
│   │   ├── models/          # Mongoose Schemas (User, Job, Resume)
│   │   ├── routes/          # Express Routers
│   │   └── services/        # BullMQ Queues, Emails, Integrations
├── frontend/
│   ├── src/
│   │   ├── components/      # UI, Community, Portfolio
│   │   ├── context/         # Auth & Socket contexts
│   │   ├── hooks/           # Custom React hooks
│   │   ├── pages/           # Route views
│   │   └── services/        # API and Socket instances
└── firebase/                # Security Rules & Indexes

New contributors should read ARCHITECTURE.md early — it includes high-level system diagrams, data-flow charts, and security notes.

---

🔌 API Reference

View API Routes & Examples

Most endpoints require a Firebase ID Token passed as an Authorization header.

Authentication

# Verify Token
GET /api/auth/verify

Resumes & AI

# Upload PDF
POST /api/upload

# Enhance Resume via Gemini AI
POST /api/enhance
Content-Type: application/json
{
  "resumeText": "...",
  "jobRole": "Frontend Engineer"
}

# ATS Analysis
POST /api/enhance/ats-analysis

Job Tracking & Alerts

# Create Job Alert
POST /api/job-alerts

# Track Application Pipeline
POST /api/job-tracker

For complete documentation, see the API Reference Guide.

---

🛠️ Troubleshooting Guide

View Solutions to Common Issues

MongoDB Connection Error (MongoServerSelectionError)

• Verify your MONGODB_URI in backend .env
• Ensure MongoDB service is running
• Check IP whitelist if using MongoDB Atlas

Redis Connection Error (ECONNREFUSED 127.0.0.1:6379)

• Ensure Redis server is installed and running
• Verify REDIS_HOST and REDIS_PORT

Port Already in Use (EADDRINUSE)

• Change the PORT value in .env
• Stop other Node instances: killall node (Mac/Linux)

---

🤝 Contributing

We welcome contributions! Please see our CONTRIBUTION.md for the Development Setup, Pull Request Process, and Coding Standards.

💙 Thank You Contributors

Thank you to all the amazing contributors who have helped improve this project.

Your efforts, pull requests, ideas, and support make this project better every day and help grow an incredible open-source community 🚀

---

📄 License

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