🚀 Career Developer AI

An AI-powered career companion — from resume building to placement success.

🚧 STATUS: UNDER ACTIVE DEVELOPMENT

This project is currently a work in progress. Many features are in prototype or build stage. The codebase is evolving rapidly and is not yet production-ready. Contributions, feedback, and ideas are highly welcome!

Career Developer AI is a full-stack intelligent platform designed to guide students and professionals through every stage of their career journey. Powered by Google Gemini AI, it offers AI-driven resume analysis, personalized skill roadmaps, mock interview prep, and a unified career dashboard — all in one place.

🚧 Project Status

This project is actively being built. Here's a snapshot of where things stand:

Module	Status
🔐 Authentication (NextAuth)	✅ Implemented
💬 AI Career Chat	✅ Beta
📄 AI Resume Analyzer	🏗️ In Progress
🎯 Placement Prep / Mock Interviews	🏗️ In Progress
🛠️ Skill Roadmap Generator	🏗️ In Progress
🏆 Hackathon Tracker	📋 Planned
🎓 Alumni Network	📋 Planned
📚 Higher Studies Guidance	📋 Planned
📊 Unified Career Dashboard	🏗️ In Progress
⚙️ Admin Panel	🏗️ In Progress

Legend: ✅ Done | 🏗️ In Progress | 📋 Planned

✨ Features & Modules

🤖 AI-Powered Features (Gemini Pro)

AI Resume Analyzer — Upload your resume and receive an ATS compatibility score, keyword gap analysis, and actionable improvement suggestions generated by Gemini.

Career AI Chat — A context-aware AI assistant specialized in career guidance, industry trends, interview tips, and job market advice.

Placement Prep — AI-generated, role-specific mock interview questions with model answers and evaluation feedback.

Skill Roadmap Generator — Enter your target job title and get a personalized, step-by-step learning path with curated resource recommendations.

Hackathon Tracker — Discover upcoming hackathons tailored to your skill set and interests, powered by AI recommendations.

📦 Platform Modules

Alumni Network — Connect with seniors and industry professionals for mentorship and referrals.

Higher Studies Guidance — Dedicated support for students aiming for MS, MBA, or PhD programs, including SOP assistance and university shortlisting.

Unified Dashboard — A single hub to track resume score, interview readiness, skill progress, and career goals.

Admin Panel — Manage users, content, and platform data from a protected admin interface.

🗂️ Project Structure

Career-Developer-AI/
│
├── prisma/                    # Prisma schema & database migrations
│   └── schema.prisma
│
├── public/                    # Static assets (icons, images)
│
├── src/
│   ├── app/                   # Next.js App Router
│   │   ├── admin/             # Admin dashboard & management
│   │   ├── ai-chat/           # Gemini AI career chat interface
│   │   ├── placement-prep/    # Mock interview & placement module
│   │   ├── resume-analyzer/   # Resume upload & AI analysis
│   │   ├── skill-roadmap/     # Skill path generator
│   │   ├── hackathon/         # Hackathon tracker
│   │   ├── alumni/            # Alumni network
│   │   ├── higher-studies/    # MS/MBA/PhD guidance
│   │   ├── dashboard/         # Unified career dashboard
│   │   └── api/               # Next.js API route handlers
│   │
│   ├── components/            # Reusable UI components
│   └── lib/                   # Utility functions
│       ├── gemini.js          # Gemini API config & helpers
│       ├── prisma.js          # Prisma client instance
│       └── auth.js            # NextAuth configuration
│
├── .env                       # Environment variables (do NOT commit)
├── .gitignore
├── eslint.config.mjs
├── jsconfig.json
├── next.config.mjs
├── package.json
└── README.md

🛠️ Tech Stack

Frontend

Next.js 15 — React framework with App Router
Tailwind CSS — Utility-first styling
JavaScript (ES2024)

Backend

Next.js API Routes — Serverless backend endpoints
Prisma ORM — Type-safe database access
NextAuth.js — Authentication & session management

AI

Google Gemini API — Core AI engine for all intelligent features

Database

PostgreSQL / MySQL (via Prisma — configurable)

🤖 Google Gemini AI Integration

All AI-powered features in Career Developer AI are built on the Google Gemini API (gemini-2.0-flash model). Gemini handles every intelligent interaction across the platform.

How Gemini Is Used

Feature	Gemini's Role
📄 Resume Analyzer	Parses resume content, scores ATS compatibility, identifies missing keywords
💬 Career AI Chat	Conversational AI answering career, industry, and job market questions
🎯 Placement Prep	Generates role-specific interview questions and evaluates answers
🛠️ Skill Roadmap	Creates personalized, structured learning paths for target job roles
🏆 Hackathon Tracker	Matches upcoming hackathons to the user's skill profile

API Call Flow

User Action (chat / resume upload / form submit)
        │
        ▼
  Next.js API Route handler
        │
        ▼
  Prompt engineered with user context
        │
        ▼
  Google Gemini API called (gemini-2.0-flash)
        │
        ▼
  Structured AI response parsed
        │
        ▼
  Response rendered in UI

Getting Your Gemini API Key

Go to https://ai.google.dev/ and sign in with your Google account
Click "Get API Key" → "Create API Key in new project"
Copy the generated API key
Paste it into your .env file as GEMINI_API_KEY (see below)

⚠️ Security: Never expose your API key in frontend code or commit it to Git. Always use server-side API routes to call Gemini so the key stays on the server.

⚙️ Installation

Prerequisites

Node.js 18 or higher
npm or yarn
PostgreSQL or MySQL database instance
A Google Gemini API key (free tier available)

Step 1 — Clone the Repository

git clone https://github.com/Lucky-939/Career-Developer-AI.git
cd Career-Developer-AI

Step 2 — Install Dependencies

npm install

Step 3 — Configure Environment Variables

Create a .env file in the root directory (see Environment Configuration below).

Step 4 — Set Up the Database

npx prisma generate
npx prisma db push

Step 5 — Start the Development Server

npm run dev

Visit: http://localhost:3000/

🔑 Environment Configuration

Create a .env file in the project root with the following variables:

# ── Google Gemini AI ──────────────────────────────────
GEMINI_API_KEY=your_google_gemini_api_key_here

# ── Database (PostgreSQL / MySQL via Prisma) ──────────
DATABASE_URL="postgresql://user:password@localhost:5432/careerdev"

# ── NextAuth Authentication ───────────────────────────
NEXTAUTH_SECRET=your_nextauth_secret_here
NEXTAUTH_URL=http://localhost:3000

# ── OAuth Providers (optional) ───────────────────────
GOOGLE_CLIENT_ID=your_google_oauth_client_id
GOOGLE_CLIENT_SECRET=your_google_oauth_client_secret

💡 Generate a NEXTAUTH_SECRET with:
openssl rand -base64 32

⚠️ Ensure .env is in your .gitignore. Never push secrets to GitHub.

🗄️ Database Setup

This project uses Prisma ORM for database access. After configuring your DATABASE_URL:

# Generate the Prisma client
npx prisma generate

# Push schema to your database (creates tables)
npx prisma db push

# (Optional) Open Prisma Studio to browse your data visually
npx prisma studio

🚀 Usage

Once the server is running at http://localhost:3000/:

Sign up / Log in using the authentication page
Upload your resume in the Resume Analyzer and receive an AI-powered ATS score and feedback
Chat with the Career AI to ask questions about job roles, industries, or interview tips
Generate your Skill Roadmap by entering your target role
Practice interviews with AI-generated mock questions in the Placement Prep module
Track your progress across all modules from the unified Dashboard

🛣️ Roadmap

Planned features and improvements for upcoming releases:

AI Resume Builder (generate resumes from scratch with Gemini)
LinkedIn profile optimizer
Real-time job listing integration (via external APIs)
Collaborative alumni mentorship booking system
Email/SMS notifications for hackathon deadlines
Multi-language support
Mobile app (React Native)
Deployment pipeline (Vercel + PlanetScale)

🤝 Contributing

Since this project is in early development, contributions are especially valuable right now!

# 1. Fork the repository on GitHub

# 2. Clone your fork
git clone https://github.com/YOUR-USERNAME/Career-Developer-AI.git

# 3. Create a new feature branch
git checkout -b feature/your-feature-name

# 4. Make your changes and commit
git add .
git commit -m "feat: describe your change here"

# 5. Push and open a Pull Request
git push origin feature/your-feature-name

Contribution Guidelines

Follow the existing code style and file structure
Keep components small and reusable
Add comments for complex logic, especially around Gemini API prompts
Test your changes locally before submitting a PR
For major changes, open an issue first to discuss your approach

🐛 Reporting Issues

Found a bug or have a suggestion? Open an issue with:

A clear title and description
Steps to reproduce the problem
Expected vs. actual behaviour
Screenshots or error logs if applicable

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

Made with ❤️ by Lucky-939 — Building the future of career development, one commit at a time.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

🚀 Career Developer AI

📌 Table of Contents

🚧 Project Status

✨ Features & Modules

🤖 AI-Powered Features (Gemini Pro)

📦 Platform Modules

🗂️ Project Structure

🛠️ Tech Stack

🤖 Google Gemini AI Integration

How Gemini Is Used

API Call Flow

Getting Your Gemini API Key

⚙️ Installation

Prerequisites

Step 1 — Clone the Repository

Step 2 — Install Dependencies

Step 3 — Configure Environment Variables

Step 4 — Set Up the Database

Step 5 — Start the Development Server

🔑 Environment Configuration

🗄️ Database Setup

🚀 Usage

🛣️ Roadmap

🤝 Contributing

Contribution Guidelines

🐛 Reporting Issues

📄 License

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 4 Commits
prisma		prisma
public		public
src		src
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
README.md		README.md
eslint.config.mjs		eslint.config.mjs
jsconfig.json		jsconfig.json
next.config.mjs		next.config.mjs
package-lock.json		package-lock.json
package.json		package.json

Folders and files

Latest commit

History

Repository files navigation

🚀 Career Developer AI

📌 Table of Contents

🚧 Project Status

✨ Features & Modules

🤖 AI-Powered Features (Gemini Pro)

📦 Platform Modules

🗂️ Project Structure

🛠️ Tech Stack

🤖 Google Gemini AI Integration

How Gemini Is Used

API Call Flow

Getting Your Gemini API Key

⚙️ Installation

Prerequisites

Step 1 — Clone the Repository

Step 2 — Install Dependencies

Step 3 — Configure Environment Variables

Step 4 — Set Up the Database

Step 5 — Start the Development Server

🔑 Environment Configuration

🗄️ Database Setup

🚀 Usage

🛣️ Roadmap

🤝 Contributing

Contribution Guidelines

🐛 Reporting Issues

📄 License

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages