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 |
| 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 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 |
| 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 |
# 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.pyRequirements: Python 3.9+
[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
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)
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
╭──────────────── 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 │
╰──────────────────────────────────────────────────────╯
What's planned for future versions of TGV-CareerCompass
- 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
- 🐍 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
- 🤝 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)
- 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
See CONTRIBUTING.md for how to add career paths, certifications, or UI improvements.
All contributions welcome — career data, translations, bug fixes, and features.
If TGV-CareerCompass helped you navigate your career, consider buying me a coffee:
MIT — free to use, modify, and distribute.
🧭 Made with ❤️ by thegr8val — stay curious, keep hacking (ethically)
