Ace your next interview with real-time AI voice interviews, instant feedback, and personalized preparation tools.
- About
- Features
- Tech Stack
- Architecture
- Project Structure
- Getting Started
- Environment Variables
- Available Scripts
- API Routes
- Deployment
- Contributing
- Team
- License
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
- 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
- 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
- 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
- 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
- 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
- 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
- View all past interviews with scores and feedback
- Quiz history with topic-wise performance
- Saved questions and bookmarks
- Performance analytics dashboard
- 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
| 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 |
┌─────────────────────────────────────────────────────────────┐
│ 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 │
└─────────────┘
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
- 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
git clone https://github.com/SrijaVuppala295/AI_MEET.git
cd AI_MEETnpm installCreate a .env file in the root directory (see Environment Variables below for full list):
cp .env.example .envFill in all required values.
npm run devOpen http://localhost:3000 to see the app.
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.envto version control. Ensure.envis listed in.gitignore.
| 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 |
| 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 |
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_threeThe project includes a netlify.toml configuration:
[build]
command = "npm run build"
publish = ".next"
[[plugins]]
package = "@netlify/plugin-nextjs"- Connect your GitHub repository to Netlify
- Set all environment variables in Netlify → Site Settings → Environment Variables
- Deploy
npx vercelThe project includes firebase.json for Firebase Hosting configuration.
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit your changes:
git commit -m 'Add amazing feature' - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request
Developed by students of Bhoj Reddy Engineering College for Women
Department of Information Technology
This project is for educational purposes. All rights reserved.
⭐ Star this repo if AI MEET helped you prepare for your interviews!