Skip to content
SrijaVuppala295Public

About

AI Meet is a full-stack interview preparation platform that helps users practice technical interviews through AI-powered voice interactions. It supports resume and job description analysis, company-specific interview questions, AI-generated feedback, quizzes, interview analytics, and an integrated AI assistant for personalized interview

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

30 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AI MEET Logo

AI MEET — AI-Powered Mock Interview Platform

Ace your next interview with real-time AI voice interviews, instant feedback, and personalized preparation tools.

Next.js React TypeScript Firebase Groq Vapi Tailwind


📋 Table of Contents


🎯 About

AI MEET is a full-stack AI-powered mock interview preparation platform developed by students of Bhoj Reddy Engineering College for Women, Department of Information Technology. It simulates realistic interview experiences using voice AI, provides instant structured feedback, and offers comprehensive tools to help candidates prepare for technical, behavioral, and HR interviews at top tech companies.

Unlike traditional prep tools, AI MEET offers:

  • Real-time voice-based interviews via Vapi AI agents
  • AI-generated feedback with category-wise scoring
  • Resume-based personalized preparation
  • Company-specific question banks for 200+ companies
  • AI-generated quizzes with progress tracking
  • 24/7 AI chatbot for interview guidance

✨ Features

🎙️ AI Mock Interviews

  • Voice-based mock interviews with an AI interviewer powered by Vapi AI
  • Choose your role (Frontend, Backend, Full Stack, DevOps, etc.)
  • Select interview type — Technical, Behavioral, or Mixed
  • Pick experience level — Entry, Mid, or Senior
  • Specify your tech stack (React, Node.js, Python, AWS, etc.)
  • Configure number of questions (1–10)
  • Real-time speech-to-text via Deepgram Nova-2
  • Natural voice responses via ElevenLabs

📊 Instant AI Feedback

  • 5-category scoring system:
    • Communication Skills
    • Technical Knowledge
    • Problem Solving
    • Cultural Fit
    • Confidence & Clarity
  • Overall score with detailed assessment
  • Highlighted strengths and areas for improvement
  • Full interview transcript review

📝 Prep Hub

  • Upload your resume (PDF, TXT, DOC)
  • Paste a job description
  • AI generates 8 tailored interview Q&A pairs specific to your application
  • Get 6–8 resume improvement tips with priority levels (High/Medium/Low)
  • Powered by Groq Llama 3.3 for fast inference

📚 Quiz Module

  • AI-generated MCQ quizzes on 12 topics:
    • JavaScript, TypeScript, React, Node.js, System Design, DSA, CSS/HTML, SQL, Git, Docker, AWS, HR
  • Randomized questions per session
  • Score tracking with visual progress charts (via Recharts)
  • Detailed answer explanations with AI-powered follow-up scoring

🏢 Question Bank

  • Company-tagged problems for 8+ companies:
    • Google, Amazon, Microsoft, Meta, Spotify, Reddit, Pinterest, Adobe
  • Category-wise questions with hints and solutions
  • Search and filter by difficulty level
  • Organized by topic and company patterns

🤖 AI Chatbot (24/7)

  • Always-available assistant for:
    • Platform feature guidance
    • Interview preparation tips
    • Resume writing advice
    • Career advice for SWE roles
    • DSA and system design help
  • Markdown-rendered responses with proper formatting
  • Topic-restricted to interview prep only
  • Powered by Groq Llama 3.3 via server-side API route

👤 User Profile & Analytics

  • View all past interviews with scores and feedback
  • Quiz history with topic-wise performance
  • Saved questions and bookmarks
  • Performance analytics dashboard

🔐 Authentication

  • Firebase Authentication with email/password
  • Secure sign-up and sign-in flows
  • Protected routes with server-side session validation
  • Firebase Admin SDK for server-side auth

🛠️ Tech Stack

Layer Technology
Framework Next.js 15.5 (App Router, Turbopack)
Language TypeScript 5
UI Library React 19
Styling Tailwind CSS 4, Radix UI, shadcn/ui
Voice AI Vapi AI (Deepgram transcriber + ElevenLabs voice)
AI Models Groq (Llama 3.3 70B Versatile), Google Gemini (feedback)
Database Firebase Firestore
Authentication Firebase Auth (email/password)
Forms React Hook Form + Zod validation
Charts Recharts
File Parsing pdf-parse-fork, Mammoth (DOCX)
Deployment Netlify (configured)
Font Mona Sans, Geist

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                        Client (Browser)                      │
│  ┌─────────┐ ┌──────────┐ ┌────────┐ ┌──────┐ ┌──────────┐ │
│  │Interview│ │ Prep Hub │ │  Quiz  │ │Q Bank│ │ Chatbot  │ │
│  └────┬────┘ └────┬─────┘ └───┬────┘ └──┬───┘ └────┬─────┘ │
└───────┼──────────┼─────────┼────────┼──────────┼───────────┘
        │          │         │        │          │
        ▼          ▼         ▼        ▼          ▼
┌─────────────────────────────────────────────────────────────┐
│                   Next.js API Routes                         │
│  /api/vapi/*    /api/prep-hub/*  /api/quiz/*   /api/chatbot │
│  /api/interview/feedback                                     │
└───────┬──────────┬─────────┬────────┬──────────┬───────────┘
        │          │         │        │          │
   ┌────▼────┐ ┌───▼───┐ ┌──▼──┐ ┌──▼───┐ ┌────▼────┐
   │ Vapi AI │ │ Groq  │ │Groq │ │ JSON │ │  Groq   │
   │(Voice)  │ │(LLM)  │ │(LLM)│ │(Data)│ │ (LLM)  │
   └─────────┘ └───────┘ └─────┘ └──────┘ └─────────┘
                    │
              ┌─────▼──────┐
              │  Firebase   │
              │ Firestore   │
              │ + Auth      │
              └─────────────┘

📂 Project Structure

AI-InterviewAgent/
├── app/                          # Next.js App Router
│   ├── layout.tsx                # Root layout (fonts, metadata)
│   ├── globals.css               # Global styles & design tokens
│   ├── favicon.ico
│   ├── (auth)/                   # Auth route group
│   │   ├── layout.tsx            # Auth layout
│   │   ├── sign-in/              # Sign-in page
│   │   └── sign-up/              # Sign-up page
│   ├── (root)/                   # Main app route group
│   │   ├── layout.tsx            # App layout (header/footer)
│   │   ├── page.tsx              # Home page
│   │   ├── interview/            # AI Interview pages
│   │   ├── prep-hub/             # Prep Hub page
│   │   ├── quiz/                 # Quiz module pages
│   │   ├── questions/            # Question Bank page
│   │   ├── profile/              # User profile page
│   │   ├── sign-out/             # Sign-out handler
│   │   └── api/                  # Protected API routes
│   │       ├── prep-hub/analyze/ # Resume + JD analysis API
│   │       ├── quiz/generate/    # Quiz generation API
│   │       ├── quiz/save/        # Quiz results save API
│   │       └── vapi/generate/    # Vapi workflow trigger
│   └── api/                      # Public API routes
│       ├── chatbot/              # AI Chatbot (Groq)
│       ├── interview/feedback/   # Interview feedback (Groq)
│       └── vapi/                 # Vapi webhook handler
│
├── components/                   # React components
│   ├── AIChatbot.tsx             # Floating AI chatbot widget
│   ├── Agent.tsx                 # Vapi voice agent component
│   ├── AuthForm.tsx              # Sign-in / Sign-up form
│   ├── Header.tsx                # Global navigation header
│   ├── Footer.tsx                # Global footer
│   ├── HomePage.tsx              # Landing page component
│   ├── InterviewCard.tsx         # Interview history card
│   ├── ProfileUI.tsx             # Profile dashboard
│   ├── DisplayTechIcons.tsx      # Tech stack icon renderer
│   ├── FormField.tsx             # Reusable form field
│   └── ui/                      # shadcn/ui primitives
│
├── lib/                          # Utilities & server logic
│   ├── actions/                  # Server Actions
│   │   ├── auth.action.ts        # Auth helpers (sign-up, sign-in)
│   │   ├── general.action.ts     # Interview CRUD, feedback, contact
│   │   └── history.action.ts     # Interview/quiz history queries
│   ├── key-rotator.ts            # Groq/OpenRouter API key rotation
│   ├── utils.ts                  # cn() helper, misc utilities
│   └── vapi.sdk.ts               # Vapi SDK initialization
│
├── constants/                    # App constants
│   ├── index.ts                  # Tech mappings, interviewer config, schemas
│   └── interview.ts              # Interview type definitions
│
├── types/                        # TypeScript type definitions
│   ├── index.d.ts                # Global types (User, Interview, Feedback)
│   ├── interview.ts              # Interview-specific types
│   └── vapi.d.ts                 # Vapi SDK type augmentations
│
├── data/                         # Static data files
│   ├── company-questions.json    # Company-tagged interview questions
│   └── category-questions.json   # Category-wise interview questions
│
├── firebase/                     # Firebase configuration
│   ├── client.ts                 # Client-side Firebase init
│   └── admin.ts                  # Server-side Firebase Admin init
│
├── public/                       # Static assets
│   ├── logo.svg                  # App logo
│   ├── robot.png                 # Hero illustration
│   ├── google.png                # Company logos
│   ├── amazon.png
│   ├── microsoft.png
│   ├── meta.jpg
│   ├── spotify.png
│   └── ...                       # More company logos & icons
│
├── .env                          # Environment variables (not committed)
├── .gitignore
├── firebase.json                 # Firebase hosting config
├── netlify.toml                  # Netlify deployment config
├── next.config.ts                # Next.js configuration
├── tsconfig.json                 # TypeScript configuration
├── postcss.config.mjs            # PostCSS config (Tailwind)
├── eslint.config.mjs             # ESLint configuration
├── package.json                  # Dependencies & scripts
└── README.md                     # This file

🚀 Getting Started

Prerequisites

  • Node.js ≥ 18.x
  • npm ≥ 9.x (or yarn/pnpm)
  • Firebase project with Auth + Firestore enabled
  • Groq API key(s) — Get one free
  • Vapi AI account — Sign up

1. Clone the Repository

git clone https://github.com/SrijaVuppala295/AI_MEET.git
cd AI_MEET

2. Install Dependencies

npm install

3. Configure Environment Variables

Create a .env file in the root directory (see Environment Variables below for full list):

cp .env.example .env

Fill in all required values.

4. Run the Development Server

npm run dev

Open http://localhost:3000 to see the app.


🔐 Environment Variables

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

# ─── Firebase (Client-side) ───────────────────────────────
NEXT_PUBLIC_FIREBASE_API_KEY=your_firebase_api_key
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project_id
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your_project.firebasestorage.app
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
NEXT_PUBLIC_FIREBASE_APP_ID=your_app_id

# ─── Firebase (Server-side Admin — SECRET) ────────────────
FIREBASE_PROJECT_ID=your_project_id
FIREBASE_CLIENT_EMAIL=firebase-adminsdk-xxxxx@your_project.iam.gserviceaccount.com
FIREBASE_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"

# ─── Vapi AI ──────────────────────────────────────────────
NEXT_PUBLIC_VAPI_PUBLIC_KEY=your_vapi_public_key
VAPI_PRIVATE_KEY=your_vapi_private_key
NEXT_PUBLIC_VAPI_WEB_TOKEN=your_vapi_web_token
NEXT_PUBLIC_VAPI_WORKFLOW_ID=your_workflow_id

# Vapi Assistant IDs (one per interview track)
NEXT_PUBLIC_VAPI_ASSISTANT_FRONTEND=your_assistant_id
NEXT_PUBLIC_VAPI_ASSISTANT_BACKEND=your_assistant_id
NEXT_PUBLIC_VAPI_ASSISTANT_HR=your_assistant_id
NEXT_PUBLIC_VAPI_ASSISTANT_SYSTEM=your_assistant_id
NEXT_PUBLIC_VAPI_ASSISTANT_DEVOPS=your_assistant_id
NEXT_PUBLIC_VAPI_ASSISTANT_DSA=your_assistant_id
NEXT_PUBLIC_VAPI_ASSISTANT_FULLSTACK=your_assistant_id

# ─── AI API Keys ──────────────────────────────────────────
GOOGLE_GENERATIVE_AI_API_KEY=your_google_ai_key

# Groq API Keys (supports rotation — add multiple)
GROQ_API_KEY_1=gsk_your_groq_key_1
GROQ_API_KEY_2=gsk_your_groq_key_2
# ... add more for rate limit rotation

# Client-side Groq keys (for browser-side calls)
NEXT_PUBLIC_GROQ_API_KEY_1=gsk_your_groq_key_1
NEXT_PUBLIC_GROQ_API_KEY_2=gsk_your_groq_key_2
# ... add more as needed

# OpenRouter (fallback)
OPENROUTER_API_KEY1=sk-or-v1-your_key

# ─── App URL ──────────────────────────────────────────────
NEXT_PUBLIC_APP_URL=http://localhost:3000

⚠️ Important: Never commit .env to version control. Ensure .env is listed in .gitignore.


📜 Available Scripts

Command Description
npm run dev Start development server with Turbopack
npm run build Build for production
npm start Start production server
npm run lint Run ESLint checks

🔌 API Routes

Route Method Description
/api/chatbot POST AI chatbot (Groq Llama 3.3)
/api/interview/feedback POST Generate interview feedback scores
/api/vapi POST Vapi webhook handler
/api/prep-hub/analyze POST Analyze resume + job description
/api/quiz/generate POST Generate quiz questions
/api/quiz/save POST Save quiz results with AI scoring
/api/vapi/generate GET Trigger Vapi interview workflow

API Key Rotation

The platform implements automatic API key rotation for Groq and OpenRouter to avoid rate limits. Keys are cycled using a round-robin strategy via lib/key-rotator.ts. Simply add multiple keys to your .env:

GROQ_API_KEY_1=gsk_key_one
GROQ_API_KEY_2=gsk_key_two
GROQ_API_KEY_3=gsk_key_three

🌐 Deployment

Netlify (Configured)

The project includes a netlify.toml configuration:

[build]
  command = "npm run build"
  publish = ".next"

[[plugins]]
  package = "@netlify/plugin-nextjs"
  1. Connect your GitHub repository to Netlify
  2. Set all environment variables in Netlify → Site Settings → Environment Variables
  3. Deploy

Vercel (Alternative)

npx vercel

Firebase Hosting (Alternative)

The project includes firebase.json for Firebase Hosting configuration.


🤝 Contributing

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit your changes: git commit -m 'Add amazing feature'
  4. Push to the branch: git push origin feature/amazing-feature
  5. Open a Pull Request

👥 Team

Developed by students of Bhoj Reddy Engineering College for Women
Department of Information Technology


📄 License

This project is for educational purposes. All rights reserved.


⭐ Star this repo if AI MEET helped you prepare for your interviews!

About

AI Meet is a full-stack interview preparation platform that helps users practice technical interviews through AI-powered voice interactions. It supports resume and job description analysis, company-specific interview questions, AI-generated feedback, quizzes, interview analytics, and an integrated AI assistant for personalized interview

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages