🎯 Agentic AI Career Guidance Platform

Your Personal AI-Powered Career Coach

🌟 What Is This Platform?

Imagine having a personal career coach that's available 24/7, knows about thousands of career paths, and can create custom learning plans just for you. That's exactly what this platform does!

The Agentic AI Career Guidance Platform is a smart web application that helps students and professionals discover their ideal career path and provides step-by-step learning roadmaps to achieve their goals.

🎪 How It Works (The Magic Behind the Scenes)

You tell us your interests → We generate a personalized quiz
You take the quiz → AI analyzes your knowledge level
AI finds perfect careers for you → Based on your skills and interests
Get your custom roadmap → 12-week learning plan with real resources
Track your progress → Mark tasks complete as you learn

🚀 What Can You Do With This Platform?

1. 📝 Discover Your Perfect Career Match

Enter any career field you're curious about (like "Web Developer" or "Data Scientist")
Get 2-3 carefully selected career recommendations that match your interests

2. 🧠 Take Personalized Knowledge Quizzes

Answer 10 smart questions designed just for your chosen field
Questions adapt based on what career you're exploring
No generic tests - everything is tailored to YOU

3. 📊 Get Your Skill Level Assessment

AI analyzes your quiz answers
Determines if you're a Beginner, Intermediate, or Advanced learner
No judgment - just honest assessment to help you grow

4. 💰 See Real Career Data

Average salaries for each recommended career
Essential skills you'll need to develop
Tools and technologies professionals actually use
Career growth opportunities and paths

5. 🗺️ Get Custom 12-Week Learning Roadmaps

Detailed week-by-week learning plan
Direct links to high-quality online courses and resources
Practical tasks and projects to build your portfolio
Everything organized and easy to follow

6. ✅ Track Your Learning Progress

Mark individual tasks as completed
See your progress visually
Never lose track of where you are in your journey

7. 💾 Save and Revisit Everything

All your quizzes, recommendations, and progress are saved
Return anytime to continue where you left off
View all your past sessions and learning paths

🛠️ The Technology That Powers This Platform

Don't worry - you don't need to understand this to use the platform! This is just for the curious minds.

🧱 What's Built With What

The Smart AI Brain:

LangChain: Coordinates all the AI agents that work for you
Groq: Lightning-fast AI that generates content and analyzes your responses
Tavily Search: Finds the most current career information and learning resources from across the web

The Backend (Server Side):

FastAPI: A super-fast Python framework that handles all requests
MongoDB: Stores all your data securely
Python: The programming language that ties everything together

The Frontend (What You See):

React: Creates the interactive user interface
Vite: Makes everything load quickly
Modern CSS: Makes everything look beautiful and responsive

🏗️ How Everything Connects

Think of it like a restaurant:

You (the customer) → Use the website interface
The waiter (Frontend) → Takes your order and brings your food
The kitchen (Backend API) → Processes your requests
The chef (AI Agents) → Creates personalized content for you
The pantry (Database) → Stores all your information safely

🎯 Step-by-Step User Journey

Step 1: Starting Your Career Discovery

Visit the homepage
Enter a career field you're interested in (examples: "Frontend Developer", "Digital Marketing", "Cybersecurity")
Click "Start Assessment"

Step 2: Taking Your Personalized Quiz

Answer 10 questions tailored to your chosen field
Questions range from basic concepts to practical applications
Don't worry about perfect answers - this helps us understand your current level

Step 3: Discovering Your Career Matches

AI analyzes your responses instantly
Receive 2-3 career recommendations perfect for your skill level
Each recommendation includes:
- Average salary ranges
- Required skills breakdown
- Essential tools and technologies
- Growth potential and career paths

Step 4: Choosing Your Path

Review all recommended careers
Click "Enroll" on the one that excites you most
This becomes your active learning track

Step 5: Getting Your Custom Roadmap

Click "View Roadmap" for your enrolled track
Receive a detailed 12-week learning plan with:
- Week-by-week goals and milestones
- Direct links to courses, tutorials, and resources
- Practical projects to build your portfolio
- Skills checkpoints to measure progress

Step 6: Learning and Tracking Progress

Follow your roadmap week by week
Mark tasks as complete when finished
Watch your progress bar grow
Celebrate your achievements!

Step 7: Monitoring Your Journey

Visit the Progress Tracker to see overall advancement
Check Session Summary for a complete overview
Access past sessions anytime from All Sessions page

🚀 Getting Started - For Developers

Want to set this up yourself? Here's how!

What You'll Need First

Python 3.9 or newer installed on your computer
Node.js (the latest stable version)
MongoDB database (local installation or cloud account)
API keys from Groq and Tavily (both free to get)

Step-by-Step Setup

1. Get the Code

git clone https://github.com/your-username/Agentic-Career-Pathfinder.git
cd Agentic-Career-Pathfinder

2. Set Up the Backend (Server)

cd backend
python -m venv venv
# Windows users:
.\venv\Scripts\activate
# Mac/Linux users:
source venv/bin/activate
pip install -r requirements.txt

3. Set Up the Frontend (User Interface)

cd ../frontend
npm install

4. Configure Your Settings Create these files with your API keys:

backend/.env:

MONGO_URI="mongodb://localhost:27017/pathfinder"
TAVILY_API_KEY="your_tavily_key_here"
GROQ_API_KEY="your_groq_key_here"

frontend/.env:

VITE_API_BASE_URL=http://127.0.0.1:8000

5. Start Your Application

Terminal 1 (Backend):

cd backend
uvicorn main:app --reload

Terminal 2 (Frontend):

cd frontend
npm run dev

6. Open Your Browser Go to http://localhost:5173 and start exploring!

🎨 Features That Make This Special

🤖 Intelligent AI Agents

Quiz Generator: Creates relevant questions for any career field
Level Detector: Accurately assesses your current skill level
Career Recommender: Finds careers that match your profile perfectly
Roadmap Creator: Builds detailed learning paths with real resources

🌐 Real-Time Data Integration

Current salary information from job markets
Up-to-date skill requirements from industry sources
Fresh learning resources and course recommendations
Latest tools and technologies being used by professionals

📱 User-Friendly Design

Clean, intuitive interface that anyone can use
Responsive design that works on phones, tablets, and computers
Fast loading times and smooth interactions
Progress tracking that keeps you motivated

💾 Smart Data Management

Everything is saved automatically
Return anytime to continue your journey
View your learning history and achievements
Compare different career paths you've explored

🔮 What Makes This Different

Traditional Career Guidance:

Generic advice that applies to everyone
Static information that gets outdated quickly
One-size-fits-all approach
Limited follow-up or progress tracking

Our AI-Powered Approach:

Personalized recommendations based on YOUR responses
Real-time data that's always current
Adaptive learning paths that grow with you
Continuous support throughout your learning journey

🛡️ Privacy and Security

Your data is important to us:

All personal information is stored securely
No data is shared with third parties
You control your learning journey and data
Sessions are private and accessible only to you

🤝 Get Involved

This is an open-source project, which means:

Anyone can contribute to making it better
You can suggest new features or improvements
Developers can add new AI agents or capabilities
The community helps shape the platform's future

Ways to Contribute:

Report bugs or issues you find
Suggest new career fields to include
Improve the user interface design
Add new AI capabilities or features
Help with documentation and guides

📞 Support and Community

Need Help?

Check our documentation and FAQ
Join our community discussions
Report issues on GitHub
Reach out for technical support

Stay Updated:

Follow the project on GitHub for updates
Join our community for tips and discussions
Subscribe to notifications for new features

🎯 Perfect For:

Students:

Exploring career options after graduation
Understanding skill requirements for different fields
Planning their learning journey while in school

Career Changers:

Professionals looking to switch industries
People wanting to upskill in their current field
Anyone exploring new opportunities

Lifelong Learners:

Individuals committed to continuous growth
People who want structured learning paths
Anyone seeking personalized career guidance

🌟 Success Stories

The platform empowers users to:

Discover careers they never knew existed
Get clear direction on what to learn next
Track progress and stay motivated
Access high-quality learning resources
Build confidence in their career choices

Ready to discover your perfect career path? Start your journey today and let AI guide you to success!

Name		Name	Last commit message	Last commit date
backend		backend
frontend		frontend
README.md		README.md

Latest commit

History

Folders and files

Repository files navigation