🚀 Career Copilot

AI-powered resume analyzer, JD matcher & mock interview — built specifically for Indian freshers.

---

🎬 Demo

---

✨ Features

Feature	What it does
📄 Resume Analyzer	ATS score, top 3 strengths/weaknesses, rewritten bullets in role-specific language
🎯 AI Role Fit Analyzer	Auto-runs after resume analysis — maps your resume to top 5 best-fit roles with gap analysis
🎯 JD Matcher	Paste any JD → exact keyword gaps, match score, copy-paste ready resume rewrites
🎤 Mock Interview	Real questions by role + type, write your answer, detailed AI feedback + expected answer structure
📊 Score Tracker	ATS score history — track if your resume is improving over time
📜 Interview History	All past mock sessions saved locally — review anytime
📁 PDF/DOC Upload	Drag & drop resume upload — no copy-paste needed
🔒 100% Private	Data never leaves your browser. No server, no tracking, no account needed
🆓 Forever Free	Uses your own free Groq API key (2 min setup)

---

🏗️ Architecture Overview

Career Copilot follows a strict 4-layer architecture. Every layer has exactly one responsibility — nothing bleeds into another.

┌──────────────────────────────────────────────────────────────┐
│                        UI Shell Layer                        │
│   index.html  ·  src/styles/*  ·  src/components/*           │
│   src/app.js  (events + DOM only — zero business logic)      │
└───────────────────────────┬──────────────────────────────────┘
                            │ calls with plain data
┌───────────────────────────▼──────────────────────────────────┐
│                    Pure Logic Layer                          │
│   src/core/logic/resumeLogic.js    — Resume + Role Fit       │
│   src/core/logic/jdLogic.js        — JD Matcher              │
│   src/core/logic/interviewLogic.js — Interview flows         │
│   src/core/logic/sessionState.js   — Runtime state           │
│                                                              │
│   Zero DOM · Zero CSS · Plain data in → plain data out       │
│   Portable to React Native / Electron / Node with 0 rewrites │
└──────────┬────────────────────────────┬──────────────────────┘
           │ calls                      │ reads/writes
┌──────────▼────────────┐   ┌───────────▼──────────────────────┐
│   AI Provider Layer   │   │       Data / Utils Layer         │
│   src/adapters/       │   │   src/utils/storage.js           │
│     aiProvider.js     │   │   src/utils/sanitize.js          │
│   src/api/groq.js     │   │   src/utils/markdown.js          │
│   src/prompts/        │   │   src/utils/pdfParser.js         │
│     groqPrompts.js    │   └──────────────────────────────────┘
└───────────────────────┘

Full architecture docs → .docs/architecture.md AI coding rules → .docs/AI_RULES.md

---

🔄 Request Flow

User clicks button
      │
      ▼
app.js  ──── reads DOM inputs
      │
      ▼
sanitize.js  ──── cleans + clamps all input text
      │
      ▼
Pure Logic Layer  ──── validates → calls GroqAdapter
      │
      ▼
groq.js  ──── circuit breaker → Groq API → structured response
      │
      ▼
Pure Logic Layer  ──── parses output → saves to storage/sessionState
      │
      ▼
app.js  ──── parseMarkdown → renders result in DOM

---

🚀 Run Locally

Prerequisites

• Free Groq API key → console.groq.com
• VS Code + Live Server extension

Steps

git clone https://github.com/r4huldeveloper/Career-Copilot.git
cd Career-Copilot
code .

Then: right-click index.html → Open with Live Server

⚠️ Always open via Live Server (http://), never by double-clicking (file://). ES modules require an HTTP server.

Get Your Free Groq API Key

1. Go to console.groq.com
2. Sign up free → API Keys → Create API Key
3. Paste in the app when prompted — stored only in your browser, never sent anywhere

---

🛠️ Tech Stack

Technology	Purpose
Vanilla JS (ES Modules)	No framework overhead, no build step, instant local dev
CSS Custom Properties	Full design token system, dark mode support
PDF.js (CDN)	Client-side PDF text extraction
Groq API + Llama 3.3 70B	AI inference (~2s response time)
Vercel	Zero-config static deployment
Cloudflare Workers + D1	Anonymous global stats counter — free tier, zero PII, never pauses

---

🔒 Security & Privacy Model

• BYOK (Bring Your Own Key): Your Groq API key is stored only in your browser's localStorage, Base64-encoded. Never transmitted to any server other than Groq directly.
• Sanitization Gate: All user inputs pass through src/utils/sanitize.js before any processing. All AI output is HTML-escaped before rendering.
• No PII on server: The only backend (Cloudflare Worker) stores zero PII — only anonymous counts and role/model names. No resume text, no API keys, no IP addresses ever touch the Worker database.
• Circuit Breaker: If Groq API fails 3 times in 60s, requests are blocked for 30s — the app stays fully functional.

---

💡 Why This Architecture (Developer Notes)

• Zero build step — clone and run with Live Server. No webpack, no bundler, no npm install.
• Pure Logic Layer (src/core/logic/) is completely decoupled from the DOM. Move to React Native tomorrow — the business logic migrates with zero rewrites.
• 1-file provider swap — want to add OpenAI or Gemini? Rewrite only src/adapters/aiProvider.js.
• Structured prompt contracts — every AI prompt defines exact output format. Parsers and prompts are a coupled contract documented in architecture.md.
• AI_RULES.md governs every change — human or AI agent. No tight coupling, no visual breakage, no unstructured AI output ever gets merged.

---

🤝 Contributing

Contributions welcome! Read CONTRIBUTING.md first — every PR must pass the Zero-Escape 5-point audit.

📜 License

AGPLv3 — This project is licensed under the AGPL v3.0. We welcome contributions! However, please note that the Career Copilot brand and UI design are proprietary. If you wish to use this software for commercial purposes without the restrictions of the AGPL, please contact us for a commercial license.

---

👨‍💻 Author

Built by Rahul Sharma — built the tool he wished existed when job hunting.

---

⭐ If this helped you land a job — star the repo. Helps other Indian freshers find it.