ai-career-copilot 1.0.0

A local command-line career accelerator powered by advanced Gemini AI.

🚀 AI Career Copilot (aicc)

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 • Request Feature

---

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

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

# 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):

aicc demo

2. Ingest and Validate Your Own Resume (Multi-format & LinkedIn Sync)

# 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:

aicc analyze-resume --file my_resume.pdf --role "Data Scientist"

4. Search and Track New Roles

aicc search --query "Staff Software Engineer"

5. Calculate Semantic Alignment Score

aicc score --id job-google

6. Grounded Corporate Research

aicc research Google

7. Synthesize Application Materials

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:

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

{
  "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
• 🐙 GitHub: @balavenkatesh3322
• 💼 LinkedIn: Bala Venkatesh on LinkedIn

---

© 2026 AI Career Copilot. Released under the MIT License.