AI-Powered Adaptive Mock Interview Simulator

A real-time AI-driven mock interview platform for technical roles. Users select role, difficulty, interview type, and duration. The AI conducts a timed adaptive interview with dynamic questions and at least one intelligent follow-up per session.

Tech Stack

• Backend: .NET 8 Web API, Entity Framework Core, SQL Server, OpenAI/OpenRouter API
• Frontend: React 19 + Vite 7 + TypeScript

Features

• Role + difficulty + interview type + duration selection
• Timed interview session with live countdown
• AI-generated questions that adapt to answer quality
• At least one intelligent follow-up per session
• Progress tracking (Question X of Y)
• Performance report with overall score (0–100), 3 strengths, 3 improvement areas, 2 improved sample answers, suggested next topics
• Session history stored in SQL Server

Setup

Prerequisites

• .NET 8 SDK
• Node.js 18+
• SQL Server or LocalDB (Windows)
• OpenAI or OpenRouter API key

Backend

cd backend

# OpenRouter (recommended - supports 400+ models):
# Windows (PowerShell):
$env:OPENROUTER_API_KEY = "sk-or-v1-your-key"

# Or add to appsettings.json:
# "OpenRouter": { "ApiKey": "sk-or-v1-your-key", "Model": "openai/gpt-4o-mini" }

# OpenAI direct (alternative):
$env:OPENAI_API_KEY = "sk-your-key"

dotnet run

OpenRouter config (in appsettings.json): OpenRouter:ApiKey, OpenRouter:BaseUrl (default: https://openrouter.ai/api/v1), OpenRouter:Model (e.g. openai/gpt-4o-mini, google/gemini-pro). OpenRouter is used if OpenRouter:ApiKey is set; otherwise OpenAI is used.

SQL Server connection: Default uses LocalDB ((localdb)\\mssqllocaldb). For full SQL Server, set in appsettings.json:

"DefaultConnection": "Server=localhost;Database=InterviewSimulator;User Id=sa;Password=YourPassword;TrustServerCertificate=True;"

Backend runs at http://localhost:5018.

Frontend

cd frontend
npm install
npm run dev

Frontend runs at http://localhost:5173 with API proxy to the backend.

Run Both

1. Start backend: cd backend && dotnet run
2. Start frontend: cd frontend && npm run dev
3. Open http://localhost:5173

API Endpoints

Method	Endpoint	Description
POST	/api/interview/start	Start new interview session
GET	/api/interview/{id}/state	Get current interview state
POST	/api/interview/{id}/answer	Submit answer, get next question
GET	/api/interview/{id}/report	Get performance report
GET	/api/interview/history	List past sessions

Project Structure

Vibe-A-Thon/
├── backend/                 # .NET 8 Web API
│   ├── Controllers/         # Interview API
│   ├── Data/                # EF DbContext
│   ├── DTOs/                # Request/Response models
│   ├── Models/              # Entity models
│   └── Services/            # AI + session logic
├── frontend/                # React + Vite
│   └── src/
│       ├── api/             # API client
│       └── pages/           # Setup, Interview, Report, History
└── README.md