🌐 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.

---

📄 License

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