Unlock your professional potential with CareerCrafter, an intelligent, AI-driven platform designed to guide you from confusion to clarity in your career journey. By analyzing your unique skills and interests, CareerCrafter doesn't just suggest jobs—it builds a personalized, step-by-step roadmap to help you achieve your dream career.
CareerCrafter is packed with features to make your career planning seamless and insightful:
- 🧑💻 AI-Powered Onboarding: A sleek and simple onboarding process captures your education, interests, and aspirations to build a foundational professional profile.
- 📄 Smart Skill Assessment: Upload your resume for an AI-driven analysis of your skills, or add them manually. Our system identifies your strengths to match you with the perfect career paths.
- 🎯 Personalized Career Suggestions: Receive a curated list of career recommendations based on your profile, complete with match scores, average salary expectations, and required skills.
- 🗺️ Dynamic AI Career Roadmap: Once you choose a path, our AI generates a comprehensive roadmap, visualized as both a flowchart and a detailed timeline. This map outlines the milestones, skills, and projects you need to succeed.
- 🧭 Career Discovery Feed: Not sure where to start? Explore our TikTok-style video feed to discover different professions, get inspired, and like the careers that catch your eye.
This project is built with a modern, robust, and scalable tech stack:
- Frontend: React & Vite
- Styling: Tailwind CSS & Shadcn/ui
- AI Integration: Google Generative AI (Gemini)
- Routing: React Router DOM
- State Management: React Hooks & Context API
- Data Fetching: @tanstack/react-query
- Diagramming: Mermaid.js
To get a local copy up and running, follow these simple steps.
- Node.js (v18 or higher recommended)
- npm or yarn
- Clone the repository
git clone [https://github.com/atharvak29/CareerCrafter.git](https://github.com/atharvak29/CareerCrafter.git)
- Navigate to the project directory
cd CareerCrafter - Install NPM packages
npm install
- Set up your environment variables
- Create a
.envfile in the root of the project. - Add your Google Gemini API key:
VITE_GEMINI_API_KEY=YOUR_API_KEY
- Create a
- Run the development server
The application will be available at
npm run dev
http://localhost:8080.
Navigating your career path has never been easier. Here’s a quick guide:
Tell us a bit about yourself—your name, education, and interests. This helps us get a baseline for your recommendations.
Either upload your resume for our AI to analyze or manually input your skills. The more we know, the better your matches will be!
Based on your skills, we'll suggest a list of promising career paths. You can filter them by industry and see key details at a glance.
Choose a career that excites you, and our AI will instantly generate a personalized roadmap. This is your guide to success, with clear milestones and learning objectives.
If you're just starting, head over to the "Career Discovery" page. Watch engaging videos about different jobs to find what sparks your interest.
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request



