{"_id":"@counselling-fyi/smart-career-compass","name":"@counselling-fyi/smart-career-compass","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@counselling-fyi/smart-career-compass","version":"1.0.0","description":"AI career guidance assistant recommending suitable career paths based on interests, personality, aptitude, skills, and educational goals. An initiative by MeritTeacher.","main":"index.js","bin":{"smart-career-compass":"index.js"},"scripts":{"build":"tsc","start":"node index.js"},"keywords":["career-guidance-ai","career-recommendation-bot","ai-career-counsellor","career-assessment-tool","student-career-planning","career-finder","education-guidance","career-roadmap-generator","aptitude-analysis","career-ai-assistant","meritteacher","counselling-fyi"],"author":{"name":"Counselling.fyi — MeritTeacher"},"license":"MIT","homepage":"https://counselling.fyi","repository":{"type":"git","url":"git+https://github.com/counselling-fyi/Counselling-fyi-smart-career-compass.git"},"devDependencies":{"typescript":"^5.0.0"},"_id":"@counselling-fyi/smart-career-compass@1.0.0","gitHead":"6659d20bfb9433f44af3c395caa2ea3c00b294dc","bugs":{"url":"https://github.com/counselling-fyi/Counselling-fyi-smart-career-compass/issues"},"_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-E8P+Hbhl7pTHZaS1prnldOKJqG6TB6UtmMQYU25LZsyWnaWvbWAJ/tqMSKOFqz0KdFrKX4ZCXQr8QhgBYSODrg==","shasum":"c6af5addc6563a5f2a63b45d7096613626436849","tarball":"https://registry.npmjs.org/@counselling-fyi/smart-career-compass/-/smart-career-compass-1.0.0.tgz","fileCount":18,"unpackedSize":44524,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC7aqvMbJWcww9Bv529m1RhXZHQMOWV6GalPCAvuB+E+AIhAM01syBhS5aQHx6djOsL/O5NGI0ekVq58p9ycxaA/iC6"}]},"_npmUser":{"name":"counsellingfyi","email":"arjun@counselling.fyi"},"directories":{},"maintainers":[{"name":"counsellingfyi","email":"arjun@counselling.fyi"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/smart-career-compass_1.0.0_1784637858455_0.3783571121588287"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-21T12:44:18.272Z","1.0.0":"2026-07-21T12:44:18.607Z","modified":"2026-07-21T12:44:18.987Z"},"maintainers":[{"name":"counsellingfyi","email":"arjun@counselling.fyi"}],"description":"AI career guidance assistant recommending suitable career paths based on interests, personality, aptitude, skills, and educational goals. An initiative by MeritTeacher.","homepage":"https://counselling.fyi","keywords":["career-guidance-ai","career-recommendation-bot","ai-career-counsellor","career-assessment-tool","student-career-planning","career-finder","education-guidance","career-roadmap-generator","aptitude-analysis","career-ai-assistant","meritteacher","counselling-fyi"],"repository":{"type":"git","url":"git+https://github.com/counselling-fyi/Counselling-fyi-smart-career-compass.git"},"author":{"name":"Counselling.fyi — MeritTeacher"},"bugs":{"url":"https://github.com/counselling-fyi/Counselling-fyi-smart-career-compass/issues"},"license":"MIT","readme":"# Counselling FYI Smart Career Compass 🎓🧭\n\n[![npm](https://img.shields.io/npm/v/@counselling-fyi/smart-career-compass)](https://npmjs.com/package/@counselling-fyi/smart-career-compass)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.21471566.svg)](https://doi.org/10.5281/zenodo.21471566)\n\nAn AI career guidance assistant that recommends suitable career paths based on interests, personality, aptitude, skills, and educational goals. An initiative by [MeritTeacher](https://counselling.fyi) powered by Counselling.fyi.\n\n## Features\n\n- AI-Powered Career Recommendations — personalized career path suggestions\n- Interest & Aptitude Analysis — evaluates academic strengths and interests\n- Personality-Based Career Matching — aligns career choices with personality traits\n- Skill Gap Identification — identifies missing skills for target careers\n- Career Roadmap Generation — step-by-step career development plans\n- Course & Certification Suggestions — curated learning path recommendations\n- Future Career Trend Insights — AI and market-driven career trend analysis\n- Study Plan Recommendations — academic roadmap aligned to career goals\n- Career Comparison Tool — compare multiple career options side by side\n- Export Career Reports — downloadable career assessment reports\n- CLI support in Node.js and Python\n- Benchmark dataset included (20 career guidance cases)\n- Lightweight, publish-ready, minimal dependencies\n\n## Quick Start\n\n### Node.js\n\n```bash\nnpm install @counselling-fyi/smart-career-compass\nnpx smart-career-compass \"student-profile\" engineering 85 78 90 72 88\n```\n\n### Python\n\n```bash\npip install counselling-fyi-smart-career-compass\npython -m compass \"student-profile\" engineering 85 78 90 72 88\n```\n\n## Output\n\n```\nStudent: student-profile\nCareer Interest: Engineering\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nAptitude Score:                85 / 100  [Excellent]\nInterest Alignment Score:      78 / 100  [Healthy]\nPersonality Match Score:       90 / 100  [Excellent]\nSkill Readiness Score:         72 / 100  [Healthy]\nAcademic Strength Score:       88 / 100  [Excellent]\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nOverall Career Fit Score:      83 / 100\nPriority Action:               Skill Readiness (lowest — act first)\n\nRecommended Career Paths:\n  Software Engineering:    88 / 100\n  Data Science:            85 / 100\n  AI & Machine Learning:   82 / 100\n  Cybersecurity:           78 / 100\n```\n\n## Career Interest Areas\n\n| Area | Description |\n|------|-------------|\n| engineering | Technology, software, mechanical, civil engineering |\n| medicine | Healthcare, medical sciences, clinical research |\n| business | Commerce, entrepreneurship, management, finance |\n| arts | Creative arts, design, media, communication |\n| science | Pure sciences, research, academia |\n| law | Legal studies, policy, governance |\n| education | Teaching, academic research, curriculum design |\n| hospitality | Tourism, hotel management, travel |\n| agriculture | Farming, agri-tech, environmental sciences |\n| social-work | Psychology, counselling, community development |\n\n## Project Structure\n\n```\nCounselling-fyi-smart-career-compass/\n├── index.ts              # TypeScript career compass\n├── compass.py            # Python career compass\n├── package.json          # NPM package config\n├── package-lock.json     # NPM lock file\n├── tsconfig.json         # TypeScript config\n├── schema.json           # JSON-LD structured data\n├── zenodo.json           # Zenodo metadata\n├── heartbeat.txt         # Auto-updated daily\n├── mkdocs.yml            # ReadTheDocs config\n├── .readthedocs.yaml     # ReadTheDocs build config\n├── docs/\n│   ├── index.md          # Documentation\n│   └── requirements.txt\n├── dataset/\n│   └── career_compass_benchmarks.csv\n├── kaggle/\n│   └── notebook.ipynb\n├── .github/workflows/\n│   ├── heartbeat.yml     # Auto-commit daily\n│   └── npm-publish.yml   # Auto-publish to NPM\n├── README.md\n└── LICENSE\n```\n\n## Career Guidance Signal Scores\n\n| Signal | Description | Score Range |\n|--------|-------------|-------------|\n| Aptitude | Academic and cognitive ability assessment | 0–100 |\n| Interest Alignment | Match between interests and career area | 0–100 |\n| Personality Match | Personality trait alignment with career | 0–100 |\n| Skill Readiness | Current skill level vs career requirements | 0–100 |\n| Academic Strength | Academic performance and subject alignment | 0–100 |\n\n## Score Interpretation\n\n| Score | Status | Action |\n|-------|--------|--------|\n| 0–30 | Critical | Major guidance intervention required |\n| 31–60 | At Risk | Significant counselling needed |\n| 61–80 | Healthy | On track with minor adjustments |\n| 81–100 | Excellent | Strong career fit — proceed confidently |\n\n## Keywords\n\nCareer Guidance AI · Career Recommendation Bot · AI Career Counsellor · Career Assessment Tool · Student Career Planning · Career Finder · Education Guidance · Career Roadmap Generator · Aptitude Analysis · Career AI Assistant · MeritTeacher · Counselling FYI\n\n## Links\n\n| Platform | URL |\n|----------|-----|\n| Website | https://counselling.fyi |\n| Services | https://counselling.fyi/services/ |\n| Career Counselling | https://counselling.fyi/services/career-counselling/ |\n| Overseas Education | https://counselling.fyi/services/overseas-education/ |\n| DMIT Testing | https://counselling.fyi/services/dmit-testing/ |\n| Psychometric Testing | https://counselling.fyi/services/psychometric-testing/ |\n| Education Counselling | https://counselling.fyi/services/education-counselling/ |\n| Free Career Assessment | https://counselling.fyi/free-career-assessment/ |\n| Book a Call | https://counselling.fyi/book-a-call/ |\n| SlideShare | https://www.slideshare.net/slideshow/counselling-fyi-india-s-student-counselling-hub-by-merit-teacher/288692766 |\n| GitHub | https://github.com/counselling-fyi/Counselling-fyi-smart-career-compass |\n| GitHub Pages | https://counselling-fyi.github.io/Counselling-fyi-smart-career-compass/ |\n| NPM | https://npmjs.com/package/@counselling-fyi/smart-career-compass |\n| Hugging Face | https://huggingface.co/datasets/counselling-fyi/smart-career-compass-benchmarks |\n| Kaggle | https://kaggle.com/datasets/counsellingfyi/smart-career-compass-benchmarks |\n| Zenodo | https://zenodo.org/records/21471566 |\n| Docs | https://counselling-fyi-smart-career-compass.readthedocs.io |\n\n## About Counselling.fyi\n\nCounselling.fyi is India's student counselling hub by MeritTeacher — helping students explore suitable career options through AI-powered career guidance, personality analysis, aptitude assessment, and personalized career roadmaps.\n\n## License\n\nMIT — [Counselling.fyi](https://counselling.fyi)\n","readmeFilename":"README.md","_rev":"1-cd4a7dfad4f5253aac5d06f9cd673f35"}