🌟 Pathfinder AI

The Next-Generation Career Trajectory Simulator

An intelligent, real-time node-based career mapping platform that uses Google's Gemini 1.5 Flash to predict, visualize, and analyze your 2, 5, and 10-year career trajectories based on your unique interests and context.

---

🚀 The Problem

Deciding on a career path is often overwhelming. Traditional counseling relies on static data, generic advice, and linear models that don't account for modern, rapidly evolving industries like AI, Web3, and specialized tech.

💡 Our Solution

Pathfinder AI transforms career planning into an interactive, multi-dimensional simulation.

By deeply integrating Google Gemini, the platform generates high-fidelity career node graphs in real-time. It maps out your immediate next steps, evaluates risk/reward ratios, predicts future salary ranges, and visualizes exactly where a specific path will lead you over a 10-year horizon.

✨ Key Features

• 🧠 Dynamic Node Mapping: Infinitely expandable tree-graph visualization of career paths.
• ⚡ Gemini 1.5 Flash Engine: Lightning-fast, hyper-personalized AI analysis using custom strict schemas.
• 🎙️ Sana AI Voice Assistant: A fully integrated AI companion that provides auditory insights and answers deep-dive questions using the Web Speech API.
• 🛡️ Secure Cloud Run Backend: Fully containerized production architecture deployed on Google Cloud Run, featuring a secure server-side proxy to protect API credentials.
• 🎨 Cinematic UI/UX: Designed with Framer Motion, glassmorphism, and neon aesthetics to provide a highly engaging, immersive experience.

---

🛠️ Tech Stack

• Frontend: React, Vite, Tailwind CSS, Framer Motion, React Flow
• Backend: Node.js, Express.js (Secure API Proxy)
• AI Integration: Google Gemini API (gemini-1.5-flash)
• Deployment: Google Cloud Run & Docker Buildpacks

---

🏁 Running Locally

1. Clone the repository:

   git clone https://github.com/Mahesh-Nandigam/Pathfinder-AI.git
   cd Pathfinder-AI

2. Install dependencies:

   npm install

3. Set up Environment Variables: Create a .env file in the root directory and add your Gemini API Key:

   GEMINI_API_KEY=your_gemini_api_key_here

4. Start the Development Server:

   npm run dev

☁️ Deployment (Google Cloud Run)

This project is configured for seamless deployment to Google Cloud Run using GCP Node Buildpacks.

1. Authenticate with Google Cloud CLI.
2. Run the deployment command:

   gcloud run deploy pathfinder-service --source . --region asia-south1 --allow-unauthenticated

---

Built for the future. Designed to inspire.