Metadata-Version: 2.4
Name: ai-career-copilot
Version: 1.0.0
Summary: A local command-line career accelerator powered by advanced Gemini AI.
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: google-genai>=0.1.0
Requires-Dist: rich>=13.0.0
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: requests>=2.31.0

<div align="center">

# 🚀 AI Career Copilot (`aicc`)

[![GitHub stars](https://img.shields.io/github/stars/balavenkatesh3322/ai-career-copilot?style=for-the-badge&color=818cf8&labelColor=1e1b4b)](https://github.com/balavenkatesh3322/ai-career-copilot/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/balavenkatesh3322/ai-career-copilot?style=for-the-badge&color=34d399&labelColor=111827)](https://github.com/balavenkatesh3322/ai-career-copilot/network/members)
[![GitHub license](https://img.shields.io/github/license/balavenkatesh3322/ai-career-copilot?style=for-the-badge&color=f43f5e&labelColor=111827)](https://github.com/balavenkatesh3322/ai-career-copilot/blob/main/LICENSE)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-indigo?style=for-the-badge&logo=github&color=6366f1&labelColor=111827)](https://github.com/balavenkatesh3322/ai-career-copilot/pulls)

<img src="assets/images/banner.png" alt="AI Career Copilot Premium Banner" width="100%" style="border-radius: 12px; margin: 20px 0; border: 1px solid #1e293b;" referrerPolicy="no-referrer" />

### **The Ultimate Open-Source AI-Powered Career Accelerator & Intelligent Funnel Tracker**
*Supercharge your job application pipeline. Parse resumes, crawl positions, score compatibility, ground corporate culture research, and synthesize tailored application materials instantly.*

[Report Bug](https://github.com/balavenkatesh3322/ai-career-copilot/issues) • [Request Feature](https://github.com/balavenkatesh3322/ai-career-copilot/issues)

</div>

---

## 🎯 Why AI Career Copilot?

Modern job hunting is a numbers game, but submitting generic applications leads to silence. **AI Career Copilot (`aicc`)** is an offline-first, dual-interface (CLI + Web UI) career intelligence suite designed to treat your job search like an enterprise sales pipeline. 

By mapping your actual professional achievements directly to live job descriptions using advanced LLM reasoning, `aicc` transforms your application-to-interview ratio overnight.

---

## 🌟 Core Modules & Key Selling Points

- 📄 **Universal Profile Ingestion (`parse-resume`) [MAJOR SELLING POINT]**:
  Ingest *any* resume file format (PDF, Word `.docx`, Markdown, or `.txt`) or synchronize public **LinkedIn profiles/handles** instantly. Supports **ALL jobs, roles, and industries** (Engineering, Creative, Healthcare, Finance, Operations, etc.) with automatic parameter matching and interactive gap-filling prompts!
- ⚡ **Structured Career Analysis (`analyze-resume`) [NEW]**:
  Execute high-fidelity compatibility scans directly from your terminal. Automatically identify matching core skills, trace candidate capability gaps, formulate tailored educational course recommendations, and draft strategic resume updates with custom-styled CLI panels.
- 👤 **Local Candidate Profiler (`init`)**:
  Walk through a beautiful interactive career wizard to structure your target skillsets, milestone work histories, core values, and cultural preferences.
- 🔍 **Grounded Job Crawling (`search`)**:
  Query live positions matching your key preferences, saving them directly to your local state. Supports unlimited target domains and job sectors.
- 🎯 **Semantic Resume Scorer (`score`)**:
  Leverages state-of-the-art AI language models to calculate structured, multi-dimensional alignment scores, matching your experience nodes to target JDs.
- 🌐 **Corporate Intelligence Research (`research`)**:
  Uses AI-powered search grounding to analyze company tech stacks, recent news, and core values. It formulates deep, impressive questions to ask your interviewers.
- 📝 **Material Synthesizer (`apply`)**:
  Auto-drafts compelling, highly structured cover letters and custom resume achievement bullets aligned directly to job requirements.
- 📊 **Local Pipeline Funnel (`track`)**:
  Visualize and manage all active, applied, and saved applications inside your terminal with gorgeous, interactive ASCII tables or within a full-featured live Web Dashboard.

---

## 🎮 Dual Usage Models: Choose Your Environment

Whether you live in the terminal or prefer a visually immersive web dashboard, `aicc` adapts perfectly to your workflow.

### 💻 Option A: Interactive Web UI Dashboard
*Perfect for instant visualization, interactive state editing, and generating offline executive PDF/HTML alignment reports.*

```bash
# Install Web dependencies
npm install

# Spin up the Express-Vite proxy backend and client environment
npm run dev
```
*Open **http://localhost:3000** to preview the dashboard. Includes state synchronization with your local tracking state database!*

### 🚀 Option B: Standalone Terminal CLI
*Perfect for software engineers and keyboard-power users who want career utilities fully integrated into their local shells as global executable commands.*

```bash
# Set up a clean virtual environment
python -m venv venv
source venv/bin/activate  # Windows: .\venv\Scripts\activate

# Install the package locally in editable/development mode
pip install -e .

# Or install it directly from a local folder or Git repository
pip install .
# pip install git+https://github.com/balavenkatesh3322/ai-career-copilot.git

# Once published on PyPI, simply run:
# pip install ai-career-copilot

# You now have instant global access to 'aicc' and 'ai-career-copilot'!
aicc --help
```

---

## ⚡ Quick Start Command Examples

### 1. Run the End-to-End Simulation Demo
Instantly simulate the entire intelligence pipeline (profiling, crawling, scoring, grounded research, material synthesis):
```bash
aicc demo
```

### 2. Ingest and Validate Your Own Resume (Multi-format & LinkedIn Sync)
```bash
# Standard Workspace File Ingestion (PDF/DOCX/TXT/MD)
aicc parse-resume --file resume.pdf

# Synchronize directly from a LinkedIn URL/Handle
aicc parse-resume --linkedin https://linkedin.com/in/alexcarter

# Direct text string ingestion
aicc parse-resume --text "Name: Alex Carter \n Skills: Python, TypeScript..."
```

### 3. Analyze Compatibility & Skill Gaps
Get instant, highly structured feedback on a resume for any specific target role:
```bash
aicc analyze-resume --file my_resume.pdf --role "Data Scientist"
```

### 4. Search and Track New Roles
```bash
aicc search --query "Staff Software Engineer"
```

### 5. Calculate Semantic Alignment Score
```bash
aicc score --id job-google
```

### 6. Grounded Corporate Research
```bash
aicc research Google
```

### 7. Synthesize Application Materials
```bash
aicc apply job-google
```

---

## 📊 Beautiful CLI Visualization

When you analyze a resume or track your active pipeline, `aicc` outputs highly structured, beautifully spaced terminal frames:

```text
❯ aicc analyze-resume --file my_resume.pdf
[AI Career Copilot Analysis]:
✔ Found 8 skill matches for target role (Data Scientist).
⚠️ Identified 3 key skill gaps: Spark, AWS SageMaker, A/B Testing.
➔ Recommendation: Complete the 'Scalable ML on AWS' course on Coursera.
➔ Suggested resume updates: Quantify achievements in your [Previous Job] role.
[Task complete]
```

---

## 🗄️ Offline-First Local Data Format

All profile records and application statuses are stored safely on your system inside a single JSON tracking database: `ai_career_copilot_state.json`.

```json
{
  "profile": {
    "name": "Alex Carter",
    "title": "Senior Software Engineer",
    "summary": "Experienced full-stack developer specializing in scalable React applications...",
    "skills": ["TypeScript", "React", "Node.js", "Express", "PostgreSQL"],
    "experiences": [],
    "values": ["Continuous Learning", "Product Polish"]
  },
  "jobs": []
}
```
*This local database is fully compatible and synchronizes in real-time between your CLI operations and the Web Dashboard emulator!*

---

## 🗺️ Engineering Roadmap

- [ ] **OpenAI Integration**: Configurable `.env` support for `gpt-4o` and `gpt-4o-mini`.
- [ ] **Anthropic Claude Support**: Deep semantic reasoning utilizing `claude-3-5-sonnet` capabilities.
- [ ] **Local LLM Models**: Offline-first profiling via local models like `llama3`, `mistral`, and `gemma2` running on device via Ollama.
- [ ] **Browser Extension Companion**: Directly scrape and score job descriptions straight from LinkedIn, Indeed, and Glassdoor in one click.

---

## 🤝 Contributing & Community Power

We are growing rapidly and love open-source contributions! Whether you are looking to fix bugs, optimize prompts, extend LLM integrations, or polish our Web UI, your contributions are welcome.

### How to Contribute:
1. **Fork** the repository.
2. **Create a branch** for your feature: `git checkout -b feature/amazing-new-capability`
3. **Commit** your changes: `git commit -m 'feat: add amazing new compatibility engine'`
4. **Push** to the branch: `git push origin feature/amazing-new-capability`
5. **Open a Pull Request**!

*Don't forget to **Star** ⭐ and **Fork** 🍴 this repository to help show support for open-source career automation!*

---

## 👥 Lead Contributors & Authors

The `ai-career-copilot` initiative is maintained and crafted by an elite circle of automation and system architects.

### 👤 Bala Venkatesh — Lead Systems Architect & Principal Engineer
Bala is an expert software craftsman specializing in building high-fidelity developer automation toolkits, intelligent pipeline orchestrators, and highly responsive user-interface environments.

*   🌐 **Portfolio Website:** [Bala Venkatesh Profile](https://balavenkatesh3322.github.io/bala_venkatesh_profile/)
*   🐙 **GitHub:** [@balavenkatesh3322](https://github.com/balavenkatesh3322)
*   💼 **LinkedIn:** [Bala Venkatesh on LinkedIn](https://www.linkedin.com/in/bala-venkatesh-67964247/)

---

<div align="center">
  <p>© 2026 AI Career Copilot. Released under the MIT License.</p>
</div>
