Disha Darshak AI is a comprehensive, AI-driven web application designed to guide students and early-career professionals through the complexities of career planning. It transforms overwhelming choices into a clear, personalized, and actionable journey, leveraging the power of Google's Vertex AI to provide expert-level guidance at scale.
- The Problem We Solve
- Key Features
- Live Demo
- Technology Stack
- 🧠 AI & Genkit Integration
- Getting Started
- Project Structure
- Future Roadmap
- License
- Contact
Navigating the early stages of a career is often a confusing and stressful experience. Young professionals face a flood of information, unclear career paths, and immense pressure to make the "right" decisions. Disha Darshak AI addresses these pain points by providing a centralized platform that offers:
- Clarity over Confusion: Replacing guesswork with data-driven, personalized recommendations.
- Personalization: Using Generative AI to deliver guidance tailored to each user's unique profile.
- Confidence Building: Offering tools to practice and prepare for real-world challenges like interviews.
- Actionable Guidance: Moving beyond simple advice to provide structured, step-by-step roadmaps.
-
📝 AI Skill-set Finder: A multi-step assessment that analyzes a user's skills and interests to recommend the top 3 career paths. It then generates a detailed, personalized roadmap for the user's chosen role, including skills to develop, learning resources, and project ideas.
-
🔥 TorchMyResume (Rank & Roast):
- Rank: Upload a resume and get an instant, AI-generated score on its effectiveness for a specific job role, complete with strengths, weaknesses, and missing keywords.
- Roast: Get brutally honest, humorous, and surprisingly insightful feedback to make your resume unforgettable.
-
🤖 AI Mock Interview: A realistic voice-enabled interview simulation tailored to a specific job role and difficulty level. After the session, the user receives a comprehensive evaluation of their performance, including a soft-skill score and detailed feedback.
-
💬 AI Career Advisor Chat: A context-aware chatbot. Now features a ✨ Personalized Mode that, with a single click, pulls the user's complete profile, skills, and past evaluation results to provide deeply holistic and tailored guidance.
-
📊 Live Job Market Explorer: An interactive dashboard powered by a robust data pipeline.
- Data Pipeline: A Google Apps Script automatically fetches data daily from the Adzuna API and stores it in Google Sheets.
- Visualization: An embedded Google Looker Studio dashboard visualizes this data, showing trends for top job categories, salary distributions, geographic hotspots, and top hiring companies.
-
📰 Trending Career News: A homepage widget that pulls the latest articles related to career trends, the job market, and hiring from the GNews API, keeping users informed.
-
👥 Community Platform: A dedicated social space for users to create posts, share professional insights, follow peers, and build a supportive network.
-
🎙️ Disha Talks: A curated content hub featuring inspirational articles and mock podcasts (success stories, expert interviews) on career growth and industry trends.
-
👤 Comprehensive User Profile: A central dashboard that stores a user's personal details, chosen career path, and a complete history of all their assessments, resume reviews, and mock interviews, creating a persistent record of their career journey.
Check out the live, deployed version of the application here: Disha-Darshak-AI
This project is built with a modern, scalable, and type-safe technology stack.
-
Frontend:
- Framework: Next.js 14 (with App Router)
- Language: TypeScript
- Styling: Tailwind CSS & Shadcn/UI
- State Management: React Context API
- Animation: Framer Motion
-
Backend & AI Integration:
- AI Framework: Genkit (Google's Open Source Framework)
- Generative AI Model: Google Gemini 2.5 Pro, 2.5 Flash, Generative AI TTS
- Server Environment: Node.js
- API: Next.js API Routes
-
Database & Authentication:
- Database: Firebase Realtime Database
- Authentication: Firebase Authentication
-
Data Pipeline & Business Intelligence:
- Job Data API: Adzuna API
- News API: GNews API
- Automation: Google Apps Script
- Data Storage: Google Sheets
- Dashboarding: Google Looker Studio
-
Deployment:
- Hosting: Firebase Hosting
The core intelligence of this application is powered by Genkit, which orchestrates calls to the Google Gemini Pro model. Each AI feature is implemented as a distinct, type-safe "flow."
-
path-finder.ts:geminiExplainFull: Analyzes quiz answers to generate the initial top 3 detailed career recommendations.geminiGenerateRoadmap: Takes a user's chosen role and profile to create the comprehensive, step-by-step career roadmap.
-
rank-resume.ts&roast-resume.ts:- These flows utilize Gemini's multi-modal capabilities to process an uploaded PDF resume. They analyze the document's content against a target job role to generate structured JSON feedback for ranking and roasting.
-
mock-interview-flow.ts:- Manages a multi-turn conversational interview. It maintains the history of the conversation and uses the user's resume context to ask relevant questions. At the end of the interview, it generates a final, structured JSON evaluation of the user's performance.
-
career-advice-chatbot.ts:- Takes a user's question and a comprehensive JSON object of their profile data (including past evaluations) to provide deeply personalized and context-aware responses.
To get a local copy up and running, follow these simple steps.
-
Clone the repository:
git clone https://github.com/thehimanshubansal/Disha-Darshak-AI.git cd Disha-Darshak-AI -
Install NPM packages:
npm install
-
Set up environment variables:
- Create a file named
.envin the root of the project. - Add the following keys, filling in your own credentials from your Firebase, GNews, and Adzuna projects.
# Firebase Configuration NEXT_PUBLIC_FIREBASE_API_KEY= NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN= NEXT_PUBLIC_FIREBASE_PROJECT_ID= NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET= NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID= NEXT_PUBLIC_FIREBASE_APP_ID= NEXT_PUBLIC_FIREBASE_DATABASE_URL= # GNews API (for Trending News Widget) GNEWS_API_KEY= # Adzuna API (Note: These are used in the Google Apps Script, not directly in the Next.js app) ADZUNA_APP_ID= ADZUNA_APP_KEY= # Google Cloud (for local Genkit development) GOOGLE_CLOUD_PROJECT_ID= GOOGLE_CLOUD_LOCATION=
- Create a file named
-
Set up Google Cloud Credentials for Genkit:
- Create a service account in your Google Cloud project and download the JSON key file.
- Place this file in the root of the project and name it
secret-account-key.json. - Important: Ensure your
.gitignorefile includessecret-account-key.jsonto prevent committing secrets.
-
Run the development server:
npm run dev
Open http://localhost:9002 to view it in the browser.
The project follows a standard Next.js App Router structure, with a clear separation of concerns.
Disha-Darshak-AI/
├── src/
│ ├── ai/ # All Genkit flows and AI logic
│ │ ├── flows/ # Individual AI features (ranking interview, etc.)
│ │ └── prompts/ # Markdown prompts for the AI models
│ ├── app/ # Next.js App Router pages and API routes
│ ├── components/ # Reusable React components
│ │ ├── career-compass/ # Core feature components
│ │ └── ui/ # Reusable UI elements from Shadcn
│ ├── contexts/ # Global state management (React Context)
│ ├── hooks/ # Custom React hooks
│ ├── lib/ # Utility functions, constants, Firebase config
│ └── types/ # Global TypeScript types
├── docs/ # Project documentation (e.g., blueprint.md)
├── public/ # Static assets (e.g., dashboard preview images)
└── ... # Config files (next.config.js, tailwind.config.ts, etc.)
This project has a strong foundation with many possibilities for future expansion:
- Deeper Profile Analytics: Create a dedicated analytics page to visualize a user's progress over time based on their saved evaluations.
- Expanded Community Features: Implement post creation, following other users, and direct messaging to foster a professional network.
- Personalized Learning Paths: Integrate with educational APIs to recommend specific courses based on a user's roadmap.
- Native Mobile App: Develop a React Native or Flutter application for a seamless mobile experience.
Distributed under the MIT License. See LICENSE for more information.
📃 Project Link: https://github.com/thehimanshubansal/Disha-Darshak-AI