Skip to content

TheGr8Val/TGV-CareerCompass

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TGV-CareerCompass 🧭

TGV-CareerCompass Logo

Your cybersecurity career navigator — powered by thegr8val

   ____                          ____                                    
  / ___|__ _ _ __ ___  ___ _ __ / ___|___  _ __ ___  _ __   __ _ ___ ___ 
 | |   / _` | '__/ _ \/ _ \ '__| |   / _ \| '_ ` _ \| '_ \ / _` / __/ __|
 | |__| (_| | | |  __/  __/ |  | |__| (_) | | | | | | |_) | (_| \__ \__ \
  \____\__,_|_|  \___|\___|_|   \____\___/|_| |_| |_| .__/ \__,_|___/___/
                                                      |_|                  
  Your cybersecurity career navigator  |  thegr8val

TGV-CareerCompass is a fully offline, interactive terminal tool that helps cybersecurity professionals at any level discover their ideal career path, the certifications to get there, and a concrete roadmap — all in under 5 minutes.

🌐 Bilingual: English / Español  |  🔒 No API keys  |  ✈️ No internet required after install


✨ Features

Feature Description
🧭 10-question assessment Covers background, interests, work style, coding level, environment & timeline
🎯 Career path scoring Keyword-weighted algorithm matched against 12 cybersecurity career paths
📊 Rich terminal UI Panels, tables, ASCII bar charts, trees, progress bars, and spinners
🏆 Top 3 path matches Match %, salary (CAD/USD), demand level, and time to entry
📜 Tiered cert roadmap NOW / NEXT / ADVANCED with cost, difficulty, prep time, and fit reasoning
🗺️ Career roadmap tree Short, medium, and long-term milestones visualized as a tree
🔍 Skill gap analysis Your current level vs required — with resources to close each gap
📚 Free resource curation Prioritizes free learning per career path
💾 Markdown report export Full report saved to reports/career_report_[timestamp].md
🎬 Matrix processing animation Because aesthetics matter
🌐 Fully bilingual All prompts and output adapt to English or Español
🔒 100% offline No API calls, no telemetry, no accounts required

🛡️ Career Paths Covered

# 🛤️ Career Path 📈 Demand 💰 Avg Salary (USD)
1 🕵️ Threat Hunter 🟢 Very High $115,000
2 💀 Penetration Tester / Red Teamer 🟢 High $125,000
3 🖥️ SOC Analyst (L1/L2/L3) 🟢 Very High $80,000
4 🔥 Incident Responder / DFIR 🟢 High $120,000
5 🌐 Threat Intelligence Analyst 🟢 High $110,000
6 ☁️ Cloud Security Engineer 🟢 Very High $140,000
7 💻 Application Security Engineer 🟢 Very High $135,000
8 🏗️ Security Engineer / Architect 🟢 High $155,000
9 📋 GRC Analyst / CISO Track 🟢 High $105,000
10 🦠 Malware Researcher / Reverse Engineer 🟡 Medium $145,000
11 🐛 Bug Bounty Hunter 🟡 Medium $90,000
12 🟣 Purple Teamer 🟢 High $130,000

📜 Certifications Catalog

Category Certifications
🔵 CompTIA Security+, Network+, CySA+, CASP+, PenTest+
🔴 Offensive OSCP, PNPT, CEH, GPEN, GWAPT
🟢 Defensive GCIH, GCIA, GCFE, BTL1
☁️ Cloud AWS Security Specialty, AZ-500, GCP Security
🧬 Intel / Forensics GCTI, GREM, GCFE
🏛️ Management CISSP, CISM, CRISC, CCSP

⚡ Quick Start

# 1. Clone
git clone https://github.com/TheGr8Val/TGV-CareerCompass.git
cd TGV-CareerCompass

# 2. (Recommended) Virtual environment
python -m venv .venv
source .venv/bin/activate        # macOS/Linux
.venv\Scripts\activate           # Windows

# 3. Install dependencies
pip install -r requirements.txt

# 4. Launch 🚀
python main.py

Requirements: Python 3.9+


🎮 How It Works

 [1] 🎨 Banner screen       ASCII art + branding
 [2] 🌐 Language selection  English / Español
 [3] ❓ 10 questions        Progress bar + encouragement messages
 [4] ⚡ Processing          Matrix animation + spinner
 [5] 📊 Results             Match table, cert roadmap, skill gap, resources
 [6] 💾 Save report         Optional Markdown export → reports/
 [7] 🔁 Replay or exit

🗂️ Project Structure

TGV-CareerCompass/
├── 🚀 main.py                  ← entry point
├── 📦 requirements.txt
├── 🧭 compass/
│   ├── banner.py               ← ASCII art + welcome/goodbye screens
│   ├── questions.py            ← questionnaire + scoring algorithm
│   ├── paths.py                ← career path helpers + skill gap
│   ├── certs.py                ← certification catalog + recommendations
│   ├── visualizer.py           ← all Rich UI rendering
│   └── report.py               ← Markdown report generator
├── 📂 data/
│   ├── career_paths.json       ← 12 career path definitions
│   └── certifications.json     ← 23 certification entries
├── 🖼️  assets/                  ← logo
└── 📁 reports/                 ← generated reports (gitignored)

🧠 Scoring Algorithm

Each answer maps to weighted keywords that accumulate into a score profile. That profile is matched against every career path's match_keywords array, then normalized for a clean visual spread.

User Answer → Weighted Keywords → Keyword Score Profile
                                         ↓
                         Match against 12 career path keyword sets
                                         ↓
                         Top 3 paths ranked + percentage normalized

To tune weights: edit ANSWER_WEIGHTS in compass/questions.py
To tune path affinity: edit match_keywords in data/career_paths.json


📺 Example Output

╭──────────────── Career Path Match ─────────────────╮
│  #1  Penetration Tester / Red Teamer   95%  High   │
│  #2  Application Security Engineer     74%  High   │
│  #3  Bug Bounty Hunter                 48%  Medium  │
╰─────────────────────────────────────────────────────╯

  Penetration Tester / Red Teamer  ███████████████████████████████░░░░  95%
  Application Security Engineer    ████████████████████████░░░░░░░░░░░  74%
  Bug Bounty Hunter                 ████████████████░░░░░░░░░░░░░░░░░░░  48%

>>> NOW — Start Here
╭──────────────────────────────────────────────────────╮
│  PNPT (Practical Network Penetration Tester)         │
│  Cost: $399  |  Difficulty: Advanced  |  3 months    │
│  Why: Practical, affordable, respected in community  │
│  Free: TCM Security (YouTube), HTB Academy           │
╰──────────────────────────────────────────────────────╯

🗺️ Project Roadmap

What's planned for future versions of TGV-CareerCompass

✅ v1.0.0 — Current

  • 10-question bilingual assessment (EN/ES)
  • 12 career path definitions with full metadata
  • 23 certifications with tiered recommendations
  • Keyword-weighted scoring algorithm
  • Rich terminal UI (panels, tables, trees, bars, spinners)
  • Skill gap analysis
  • Markdown report export
  • Matrix animation + banner screen
  • 100% offline — no API keys

🔧 v1.1.0 — Planned

  • 🐍 Package as a proper Python CLI (pipx install tgv-careercompass)
  • 🎨 Additional pyfiglet font options for the banner
  • 📊 Expanded salary data (regional breakdowns: UK, AU, LATAM)
  • 🔄 Add more career paths: OT/ICS Security, Forensic Analyst, DevSecOps
  • 🌍 Portuguese (PT) language support

🚀 v1.2.0 — Future

  • 🤝 Mentorship path suggestions (communities + Discord servers per path)
  • 🏷️ Job title variations per path (what to search on LinkedIn/Indeed)
  • 📅 Personalized study schedule generator
  • 🔗 Export report to HTML with styling
  • 📱 CTF platform recommendations per path (HTB, THM, PicoCTF)

💡 Ideas & Contributions Welcome

  • Additional languages (FR, DE, AR)
  • Resume/CV tips per career path
  • Interview question banks per role
  • Salary negotiation tips

🙌 Want to help build any of these? See CONTRIBUTING.md


🤝 Contributing

See CONTRIBUTING.md for how to add career paths, certifications, or UI improvements.

All contributions welcome — career data, translations, bug fixes, and features.


☕ Support

If TGV-CareerCompass helped you navigate your career, consider buying me a coffee:

Buy Me A Coffee


📄 License

MIT — free to use, modify, and distribute.


🧭 Made with ❤️ by thegr8val — stay curious, keep hacking (ethically)

About

TGV-CareerCompass is a fully offline, interactive terminal tool that helps cybersecurity professionals at any level discover their ideal career path, the certifications to get there, and a concrete roadmap — all in under 5 minutes.

Topics

Resources

License

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages