Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

51 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš€ Career Copilot AI: Strategic Career Intelligence Suite

Python FastAPI Firebase Cloudinary Groq


Try here: https://career-copilot-wbkk.onrender.com/

๐Ÿ“– Project Description

Career Copilot AI is a professional-grade career optimization platform that integrates Large Language Models (LLMs) with cloud-native infrastructure to transform static resumes into strategic career assets.

In a modern job market driven by ATS and precise role-fit, Career Copilot provides job seekers with semantic analysis, predictive interview intelligence, and automated asset generation. It doesn't just scan for keywords; it understands the intent and impact of a user's professional journey, bridging the gap between current experience and future goals.


โœจ Detailed Features

๐Ÿ” 1. Cognitive Resume Auditing

  • Semantic Pathfinding: Uses LLaMA 3.3 to benchmark your resume against 12+ industry-specific roles (AI Engineer, Product Manager, DevOps, etc.).
  • Affinity Scoring: A weighted percentage match based on technical skills, soft skills, and leadership experience.
  • Skill Gap Mapping: Identifies "Critical Missing Keywords" and provides a prioritized learning roadmap with curated resources.

๐ŸŽค 2. Predictive Interview Intelligence

  • Resume-Contextual Questions: AI analyzes your specific projects and tenure to generate the exact questions a recruiter is likely to ask you.
  • STAR Framework Guidance: Interactive tips for structuring behavioral answers that emphasize impact and results.
  • On-Demand Generation: Use the AJAX-powered engine to generate fresh questions any time you refresh your strategy.

๐Ÿ“„ 3. Automated Professional Assets

  • High-Conversion Cover Letters: Generates context-aware letters that map your unique achievements directly to a job description.
  • Career Analysis Reports: Downloadable, high-fidelity PDF reports featuring role-fit charts and detailed strategic advice.

๐Ÿ“Š 4. Admin Intelligence Dashboard

  • Live Monitoring: Real-time visibility into user growth, file uploads, and system interactions.
  • Audit Logging: A robust internal tracking system that captures logins and system changes for security.
  • Feedback Loop: Integrated user feedback system with full CSV export capabilities for administrative review.

๐Ÿ› ๏ธ Tech Stack

Languages

  • Python 3.12+ โ€“ Core backend development and AI orchestration
  • JavaScript (ES6+) โ€“ Client-side interactivity and dynamic updates
  • HTML5 & CSS3 โ€“ Web interface structure and styling

Frameworks & Libraries

  • FastAPI โ€“ High-performance asynchronous backend framework
  • Tailwind CSS โ€“ Modern UI design and styling
  • Jinja2 โ€“ Dynamic HTML templating
  • ReportLab โ€“ PDF report generation
  • Matplotlib โ€“ Data visualization and charts
  • pdfplumber โ€“ Resume text extraction from PDFs
  • Gunicorn โ€“ Production server for deployment

Cloud & Platforms

  • Railway โ€“ Application deployment and hosting
  • Google Cloud Platform (GCP) โ€“ Cloud infrastructure services
  • Firebase Authentication โ€“ Secure Google login
  • Cloudinary โ€“ Resume storage and file management

Databases

  • Google Cloud Firestore โ€“ NoSQL database for user data and metadata
  • ChromaDB โ€“ Vector database for semantic search and AI retrieval
  • CSV / JSON Storage โ€“ Lightweight local persistence

APIs & AI

  • Groq Cloud API โ€“ Fast LLM inference
  • LLaMA 3 (70B) โ€“ Resume analysis and career guidance
  • Firebase Admin SDK โ€“ Backend authentication integration
  • Cloudinary Upload API โ€“ File upload and storage

Dev Tools

  • Git & GitHub โ€“ Version control
  • pip โ€“ Dependency management
  • python-dotenv โ€“ Environment variable management
  • Mermaid.js โ€“ Architecture diagrams

๐Ÿ—๏ธ Detailed Architecture

System Data Flow

graph TD
    subgraph Client_Experience
        U(Candidate)
        A(Administrator)
    end

    subgraph API_Orchestration[FastAPI Backend]
        Auth[Firebase Middleware]
        Parser[PDF Extractor]
        LLM[LLaMA 3.3 Engine]
        PDF[PDF Report Generator]
    end

    subgraph Persistence_Layer
        FS[(Firestore DB)]
        CD[Cloudinary CDN]
        SL[(Local Session/Audit Logs)]
    end

    U -->|Login| Auth
    U -->|Upload PDF| Parser
    Parser -->|Context| LLM
    LLM -->|Scoring| FS
    Parser -->|Storage| CD
    LLM -->|Data| PDF
    PDF -->|Report| U
    A -->|Monitor| FS
    A -->|Review| SL
Loading

Analysis Pipeline

sequenceDiagram
    participant User
    participant FastAPI
    participant LLaMA_3.3
    participant Firestore
    participant Cloudinary

    User->>FastAPI: Upload Resume (PDF)
    FastAPI->>Cloudinary: Store original file
    FastAPI->>FastAPI: Parse text (pdfplumber)
    FastAPI->>LLaMA_3.3: Analyze Experience vs Roles
    LLA_MA_3.3-->>FastAPI: Return JSON Scoring & Gap Analysis
    FastAPI->>Firestore: Cache Results & File Metadata
    FastAPI-->>User: Render Interactive Dashboard
Loading

๐Ÿš€ Installation

1. Requirements

  • Python 3.12+
  • Node/NPM (Optional for Tailwind development)

2. Local Setup

# Clone the repository
git clone https://github.com/tisha-varma/Career-Copilot.git
cd Career-Copilot

# Create and activate virtual environment
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

๐Ÿ”‘ Environment Variables

Create a .env file in the project root:

# AI Intelligence
GROQ_API_KEY=your_groq_cloud_key

# Asset Hosting
CLOUDINARY_URL=your_cloudinary_url

# Identity & Security
ADMIN_EMAILS=user1@gmail.com,user2@gmail.com
SESSIONS_DIR=_sessions

# Firebase Setup
# Ensure firebase-adminsdk.json is present in /app directory

๐Ÿ–ฅ๏ธ Usage

  1. Identity: Sign in with Google to create your personalized profile.
  2. Analysis: Upload your PDF resume. The system will benchmark you against market standards.
  3. Strategize: Review your role-fit score and technical gap analysis.
  4. Prepare: Use the "Interview Prep" section to generate AI-tailored questions for your target role.
  5. Generate: Create cover letters and download your comprehensive Career Analysis Report.

๐Ÿ”Œ API Endpoints (Core)

Endpoint Method Description
/analyze POST Parses resume and generates full career insights
/download-report GET Generates and exports the Career Analysis PDF
/generate-resume-questions GET AJAX endpoint for AI question prep
/submit-feedback POST Submits user ratings for system improvement
/admin/dashboard GET (Admin) Central monitoring command center
/admin/delete-user/{uid} DELETE (Admin) Secure profile removal

๐Ÿ–ผ๏ธ Screenshots Section

image image image image image image image image image image image

๐Ÿ“‚ Folder Structure

Career-Copilot/
โ”œโ”€โ”€ app/                     # Main Application Logic
โ”‚   โ”œโ”€โ”€ main.py              # Central Router & Lifecycle
โ”‚   โ”œโ”€โ”€ llama_analyzer.py    # LLM Analysis Logic
โ”‚   โ”œโ”€โ”€ firestore_db.py      # Firestore Repository
โ”‚   โ”œโ”€โ”€ cloudinary_storage.py# Asset Hosting Service
โ”‚   โ”œโ”€โ”€ report_generator.py  # ReportLab Orchestration
โ”‚   โ”œโ”€โ”€ audit.py             # Internal System Logging
โ”‚   โ”œโ”€โ”€ static/              # Visual CSS/JS Assets
โ”‚   โ””โ”€โ”€ templates/           # Jinja2 Dashboard Layouts
โ”œโ”€โ”€ data/                    # Feedback and Local Sessions
โ””โ”€โ”€ requirements.txt         # Core Dependencies

๐Ÿ”ฎ Future Improvements

  • ATS Optimization Score: A dedicated feature to maximize resume pass-through.
  • Mock Voice Interviews: Integration with ElevenLabs for roleplay simulations.
  • Browser Extensions: Quick analyze features for LinkedIn job postings.

๐Ÿค Contributing

Contributions are welcome! Please follow these steps:

  1. Fork the Project
  2. Create your Feature Branch (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

โš–๏ธ License

Distributed under the MIT License. See LICENSE for more information.


Built with โค๏ธ by Tisha Varma. Helping the world navigate the future of work.

About

Strategic Career Intelligence Suite: semantic resume auditing, predictive interview prep, and AI asset generation.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages